首发于Programming & Tools
让GitHub Page支持Latex公式

让GitHub Page支持Latex公式

Contact me:

Blog : cugtyt.github.io/blog/i

Email: cugtyt#qq.com, cugtyt#gmail.com

GitHub Page里的Jekyll虽然支持Markdown，但是不能正确显示公式，可以借用MathJax帮助渲染。

方法：

1 设置markdown引擎为kramdown，方法为在 _config.yml 里添加：

markdown: kramdown

2 在md文件开始输入代码：

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

然后正文就可以写公式：$ e = m c^2 $ 这样就能正确显示了。

如果要所有文档都使用mathjax，可以在主题配置文件里面的<head>标签里加入上面代码，但是实际测试发现，每次都会连接mathjax所以加载页面很慢。因此建议对需要公式显示的文档开启。

如果是在Gtihub Page搭建的时候选择的主题，仓库里看不到主题配置文件可以这样做：

1 到

github.com/pages-themes

把THEME_NAME替换为自己的主题名字，比如我的主题名字为Cayman，然后把这个文件的内容添加到自己仓库里面的 _layout/default.html。

2 在<head>标签里添加上面的内容，就可以全部文档都使用了。


参考：

编辑于 2018-07-25 16:32
GitHub
Markdown
Jekyll

文章被以下专栏收录