TeXMe终极指南：快速创建自渲染Markdown与LaTeX文档
项目地址: https://gitcode.com/gh_mirrors/te/texme 还在为复杂的文档渲染配置而烦恼吗？TeXMe让一切变得简单！这个轻量级JavaScript工具能够自动渲染包含Markdown和LaTeX的文档，无需繁琐的设置过程。无论你是学术研究者、技术文档编写者还是博客作者，TeXMe都能为你提供完美的解决方案。
为什么选择TeXMe？
在当今的技术文档和学术论文编写中，Markdown以其简洁的语法受到广泛欢迎，而LaTeX则在数学公式排版方面无可匹敌。TeXMe巧妙地将两者结合，创造出自渲染文档的奇迹。
想象一下：你只需编写内容，剩下的渲染工作全部自动完成！TeXMe就像一位贴心的助手，默默为你处理所有技术细节。
核心技术优势
零配置快速启动
只需一行HTML代码，就能创建完整的自渲染文档：
<!DOCTYPE html><script src="https://cdn.jsdelivr.net/npm/texme@1.2.2"></script><textarea>
# 欧拉恒等式
在数学中，**欧拉恒等式**是等式
$$ e^{i \pi} + 1 = 0. $$
## 详细解释
欧拉恒等式是复分析中欧拉公式的一个特例，它指出对于任何实数 $ x $，
$$ e^{ix} = \cos x + i \sin x. $$
强大数学公式支持
TeXMe集成了MathJax引擎，确保所有LaTeX数学公式都能完美显示。从简单的内联公式 $ E = mc^2 $ 到复杂的多行方程组，一切都不在话下。
灵活的样式定制
不喜欢默认样式？没问题！TeXMe提供多种样式选项：
- viewer样式：白色面板配灰色背景（默认）
- plain样式：极简风格，纯白背景
- none样式：完全无样式，可自定义CSS
<!DOCTYPE html>
<script>window.texme = { style: 'plain' }</script>
<script src="https://cdn.jsdelivr.net/npm/texme@1.2.2"></script><textarea>
# 原子理论
**原子理论**是关于物质本质的科学理论，它指出物质由称为*原子*的离散单元组成。
实用功能详解
延迟渲染控制
想要手动控制渲染时机？设置 renderOnLoad: false 即可：
<!DOCTYPE html>
<script>window.texme = { renderOnLoad: false }</script>
<script src="https://cdn.jsdelivr.net/npm/texme@1.2.2"></script>
<textarea>
# 欧拉恒等式
在数学中，**欧拉恒等式**是等式
$$ e^{i \pi} + 1 = 0. $$
</textarea>
<div><button onclick="texme.renderPage()">开始渲染</button></div>
Markdown优先环境
当代码块或图片描述中包含LaTeX分隔符时，使用 md 环境来保护内容：
<!DOCTYPE html><script src="https://cdn.jsdelivr.net/npm/texme@1.2.2"></script><textarea>
# 使用变量
\begin{md}
foo=hello echo $foo
\end{md}
变量 \begin{md}`$foo`\end{md} 在扩展后会被其值替换。
快速上手步骤
方法一：基础用法
- 创建HTML文件
- 添加TeXMe脚本
- 在
<textarea>中编写内容 - 用浏览器打开即可查看渲染结果
方法二：库模式使用
如果需要更精细的控制，可以将TeXMe作为库使用：
var texme = require('texme')
var input = '**Foo** $$ {a}_{1} {a}_{2} $$'
var output = texme.render(input)
console.log(output)
配置选项全解析
掌握这些配置选项，让你的文档渲染更加得心应手：
- useMathJax：是否启用MathJax渲染
- protectMath：保护LaTeX代码不被Markdown解析
- style：文档显示样式
- renderOnLoad：是否自动渲染
自托管方案
想要完全掌控所有资源？TeXMe支持自托管：
git clone https://gitcode.com/gh_mirrors/te/texme
然后配置本地资源路径即可实现完全离线使用。
常见问题解决方案
内容渲染异常
如果遇到渲染问题，检查是否在 <textarea> 中编写内容，这样可以避免HTML解析错误。
数学公式不显示
确保 useMathJax 选项设置为 true，并且网络连接正常。
结语
TeXMe以其轻量级、易用性和强大功能，成为Markdown与LaTeX结合的最佳解决方案。无论你是新手还是专家，都能快速上手，享受高效文档编写的乐趣。
现在就开始使用TeXMe，体验前所未有的文档编写效率吧！官方文档：meta/doc.md 源码位置：texme.js
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
