企业官网建设流程全解析

yn编辑器化学方程式 LaTeX 完整指南：三步写出可逆、带条件、能配平的规范方程式

【免费下载链接】ynA highly extensible Markdown editor featuring version control, AI Copilot, document annotations, mind maps, document encryption, executable code snippets, chart embedding, HTML applets, plugins, and macro replacement. Its integrated sidebar terminal makes working with AI faster and more convenient.项目地址: https://gitcode.com/GitHub_Trending/yn/yn

yn编辑器（A highly extensible Markdown editor）内置 KaTeX 渲染引擎并加载了 mhchem 扩展，让你在 Markdown 里直接写 LaTeX 就能得到带下标、反应条件和专业箭头的化学方程式，边输入边渲染。从确认公式渲染已开启，到水合反应的简单写法、合成氨这类复杂方程式，再到不渲染时的排查，这篇指南一次讲清。

一个公式串起完整流程：从输入到渲染

先说下思路：不用在 Word 里拖公式对象，也不用手写 HTML 标签。yn编辑器里公式就是一段普通文本，KaTeX 负责把它画成规范样式。

化学相关的部分交给 mhchem——KaTeX 的化学反应式扩展。它认识->、<=>这些记号，原子个数按普通数字写就行，不用逐字摆下标。渲染逻辑的入口在 KaTeX插件源码。

整条链路就四步：打开编辑器 → 确认渲染开关 → 输入公式 → 在右侧预览区看效果。后面几节按这个顺序往下走。

三步确认公式渲染已开启

yn编辑器默认已集成 KaTeX，一般不用装任何东西。不放心可以花半分钟核对：

1. 点击状态栏的「设置」按钮，打开设置面板；
2. 切到「Markdown」选项卡，确认「KaTeX渲染」处于勾选状态；
3. 回到文档敲一行$H_2O$，右侧预览立即出现带下标的 H₂O——链路通了。

之后想改渲染参数也不用翻全局设置，直接在文档头部的 Front Matter 里写katex配置项即可，后面配合成氨例子时会用到。

第一支方程式：下标与反应箭头

新建文档，写水合反应这一行：

$H_2O + CO_2 \rightarrow H_2CO_3$

预览里它变成规范的 H₂O + CO₂ → H₂CO₃。两个细节容易踩：元素重复出现时，每处都要单独写下标（H₂CO₃ 里 H 和 O 各带一个）；行内公式用单个$...$包裹。

箭头本身也有讲究，四种常用写法：

• \rightarrow—— 单向反应
• \rightleftharpoons—— 可逆反应
• \xrightarrow{高温}—— 箭头上方带反应条件
• \xleftarrow{催化剂}—— 箭头下方带反应条件

反应条件想上下两层同时写（比如催化剂在上、加热符号 Δ 在下），用\substack堆叠：

$A + B \xrightarrow{\substack{催化剂\\\Delta}} C$

[!IMPORTANT]\substack里的\\是换行符，两个条件之间必须带反斜杠换行，漏掉会直接报错不渲染。

用 mhchem 的 ce 命令写更长、更省事的反应式

手写\rightarrow组合到复杂反应就累了。\ce命令让 mhchem 直接解析整条反应式：下标自动、气体符号↑可以原样输入、系数随便写。

高锰酸钾与盐酸：

$\ce{2KMnO4 + 16HCl -> 2KCl + 2MnCl2 + 5Cl2↑ + 8H2O}$

注意HCl不用写成H_{Cl}，2MnCl2的 2 也自动落位。

再上难度，工业合成氨，条件分两行挂在箭头上：

$\ce{N2(g) + 3H2(g) <=>[催化剂][高温高压] 2NH3(g) ΔH = -92.4 kJ/mol}$

<=>是 mhchem 的可逆箭头，[催化剂][高温高压]分别落到箭头上下方，状态标注(g)、焓变ΔH都能自然排出来。

如果整篇文档的公式都要调样式（比如统一显示模式或字号），在文档顶部加：

--- katex: displayMode: true fontSize: 1.2em ---

公式不渲染时的快速排查

预览区没出现公式、甚至直接打出一串代码？按顺序查三处：

1. 定界符是否匹配——行内公式用$...$，块级公式用$$...$$，混用或漏一个$都不会触发渲染；
2. 括号和反斜杠是否闭合——重点看\substack{这类花括号、\\里的反斜杠数量；
3. 回到设置里把「KaTeX渲染」重勾一次确认没被改动。

有个小习惯能省掉大半排错时间：输入时敲/触发公式骨架提示（行内/块级 KaTeX 都能选），编辑器还会补 LaTeX 自动补全，语法错误当场就能发现。

太长放不下？用 split 环境拆行

一行排不下的方程式，放进$$块里用split环境按位置断开：

$$ \begin{split} \ce{2KMnO4 + 5H2C2O4 + 3H2SO4 &-> K2SO4 + 2MnSO4 + 10CO2↑ + 8H2O} \\ &\Delta H = -202.5 kJ/mol \end{split} $$

&控制对齐位置，第二行的ΔH就整齐地挂在反应式下方。

写在最后

从一行下标到带条件的可逆反应，yn编辑器里写化学方程式的路径就是：确认渲染 →$...$/$$...$$包裹 → mhchem 的\ce接管复杂式。想继续深挖，可以看 特色功能说明 里的「数学公式」一节，README 的更新日志也会持续记录公式相关的能力迭代。有问题也可以去社区群（help/qrcode-wechat.jpg）找人聊聊。

【免费下载链接】ynA highly extensible Markdown editor featuring version control, AI Copilot, document annotations, mind maps, document encryption, executable code snippets, chart embedding, HTML applets, plugins, and macro replacement. Its integrated sidebar terminal makes working with AI faster and more convenient.项目地址: https://gitcode.com/GitHub_Trending/yn/yn