显然,Github Pages 使用的 Markdown 处理器与 Github 使用的处理器不同。我在尝试在 GitHub 页面上渲染像
$O(N^2)$
这样的数学表达式时遇到了麻烦,而这些数学表达式在 Github 上工作得很好
在我的项目中,我只有一堆组织到文件夹中的 Markdown 文件,没有设置任何 Jekyll 配置文件或自定义 Github 工作流程。我尝试在项目根目录中创建一个
_config.yml
文件,其中一行为 markdown: GFM
但这不起作用
此外,像下面这样的装饰亮点可以在 Github 上运行,但不能在 Github Pages 上运行
> [!NOTE]
> Some insightful text
您在
_config.yml
中设置 Markdown 处理器的方法需要您使用 Jekyll。 (参见文档)
要添加类似的功能,您需要在 Markdown 文件中手动添加支持。
对于数学表达式,您可以使用MathJax等工具来完成。
在您的 Markdown 文件中:
<script type="text/javascript"
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>
Centred formulae:
\\[ x = {-b \pm \sqrt{b^2-4ac} \over 2a} \\]
Inline formulae:
\\( x = {-b \pm \sqrt{b^2-4ac} \over 2a} \\)
要添加对块引用样式的支持,只需将所需的 CSS 规则添加到您的 Markdown 文件中即可。
<style>
blockquote {
/* style rules */
}
</style>