Jekyll 渲染 LaTeX 数学公式

    技术2025-05-06  28

    Solution

    博客是用 MarkDown 编写的,而 MarkDown 本身并不支持公式,但是我使用的 Typora 编辑器可以扩展 LaTeX 的公式, 只要勾选 文件 -> 偏好设置 -> MarkDown -> 内联公式 ,然后再重启 Typora 就可以编辑行内的 LaTeX 公式了

    下面是在 Typora 上编辑公式展示的效果

    这在 Typora 里面是没有任何问题的,可以正常显示,但是 push 到基于 Jekyll 模板的 GitHub page 上就出现了不能渲染公式的问题,网上搜了一下,Jekyll 模板确实不支持 LaTeX 公式,不过有一种解决方法,那就是引入外部的 js脚本,可能会影响一点加载速度,但是我也没有什么明显的感觉(可能因为我挂着全局代理)

    具体方法就是,到 _config.yml 中加上一行 markdown: kramdown ,再打开 _includes 文件夹中的 head.html ,将下面这段脚本粘贴进去,提交修改,就可以正常渲染 LaTeX 公式了

    <script type="text/x-mathjax-config"> MathJax.Hub.Config({ tex2jax: { skipTags: ['script', 'noscript', 'style', 'textarea', 'pre'], inlineMath: [['$','$']] } }); </script> <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML" type="text/javascript"></script>
    Processed: 0.011, SQL: 9