KaTeX 数学排版扩展与工具完整指南【免费下载链接】KaTeXFast math typesetting for the web.项目地址: https://gitcode.com/GitHub_Trending/ka/KaTeX正文里公式一多两个问题就来了每条公式都要手动调用渲染代码写得碎读者选中公式一复制粘回编辑器就是一堆乱码。KaTeX 是一款面向 Web 的快速数学排版库在浏览器里同步渲染 LaTeX 公式它的contrib/目录提供了一套官方扩展正好覆盖这两类场景。 扩展选型速查表先看场景场景/痛点对应扩展一句话效果长文公式多逐个调用渲染太繁琐auto-render扫描文本节点带分隔符的公式自动渲染复制公式粘回编辑器就乱了copy-tex复制时剪贴板带出 LaTeX 源码化学课程页面要排反应方程式mhchem提供\ce与\pu命令语法兼容 LaTeX 生态存量页面用了 MathJax想迁移mathtex-script-type直接渲染script typemath/tex里的公式站点要适配屏幕阅读器render-a11y-string把公式转成可朗读的文本描述分场景详解每个扩展怎么用何时用 Auto-render 自动渲染公式适合正文是纯文本、公式分散在长文各处的课程页和文档站。它遍历指定容器下的文本节点识别$...$、$$...$$这类分隔符并原地渲染省去逐个调用katex.render的工作。分隔符可自定义还能排除不需要扫描的标签。script defer srccontrib/auto-render.min.js onloadrenderMathInElement(document.body)/script复制公式要出 LaTeX 源码怎么办copy-tex适合问答、作业平台等读者常复制公式回编辑器继续编辑的场景。它接管复制行为选中已渲染公式时剪贴板的文本部分变成带分隔符的 LaTeX 源码默认内联$...$、块级$$...$$改源码里的copyDelimiters即可换成\(...\)、\[...\]。只选中半条公式时会自动扩展到整条。script defer srckatex.min.js/script script defer srccontrib/copy-tex.min.js/scriptmhchem 化学式扩展怎么开适合需要排化学方程式的教育与科研页面。它给 KaTeX 增加\ce方程式和\pu单位两个命令语法与 LaTeX 生态的 mhchem 包一致写\ce{2H2 O2 - 2H2O}就能得到规范排版。注意加载位置在核心库之后、auto-render 之前。script defer srckatex.min.js/script script defer srccontrib/mhchem.min.js/script如何迁移 MathJaxmathtex-script-type适合存量页面用 MathJax、想整体换成 KaTeX 的情况。加载后它会找到页面上所有script typemath/tex标签MathJax 的惯用写法并渲染其中内容公式的存放格式一行都不用改。script defer srccontrib/mathtex-script-type.min.js/script公式继续按 MathJax 习惯写例如script typemath/texx\sqrt{1-x^2}/script。如何开启屏幕阅读器无障碍支持render-a11y-string适合对可访问性有要求的学术站点。它把公式解析后输出一串逗号分隔的语义描述例如\frac{1}{2}会得到 start fraction, 1, divided by, 2, end fraction屏幕阅读器即可按结构朗读。import renderA11yString from katex/contrib/render-a11y-string; renderA11yString(\\frac{1}{2});⚠️ 集成与避坑上线前过一遍加载顺序核心katex.min.js最先mhchem在auto-render之前否则扫描时\ce尚未注册。版本对齐核心与所有扩展保持同一版本用同一个 npm 包的katex/contrib/...子路径别混用。defer要一致若核心库去掉了defer各扩展脚本也必须同步去掉否则会报未定义。长页面控制渲染范围renderMathInElement传具体容器配合ignoredTags、ignoredClasses跳过非数学区域别默认扫整页。copy-tex 依赖 Clipboard API较老浏览器不生效属正常现象。 文档与资源contrib/ 目录五个官方扩展的源码与示例页动手前先看这里的README.mddocs/api.mdkatex.render、renderToString等 API 参考docs/autorender.mdauto-render 的分隔符、忽略标签等配置说明docs/supported.mdKaTeX 支持的 LaTeX 命令清单CONTRIBUTING.md想自己写扩展或提改进从这里入手contrib/里的扩展不给 KaTeX 增加任何额外依赖每个只解决一个场景。按上表对号入座、按顺序加载公式体验就能贴近完整的 LaTeX 生态。挑一个痛点先跑通它再逐个补齐。【免费下载链接】KaTeXFast math typesetting for the web.项目地址: https://gitcode.com/GitHub_Trending/ka/KaTeX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考