MkDocs 札记

MkDocs 札记：记录建站过程中参考的资料和解决的问题。

文档和资源¶

• MkDocs: Project documentation with Markdown.
  • 主题资源, MkDocs Themes
  • 插件资源, mkdocs/catalog
• Material for MkDocs: a powerful documentation framework (theme) on top of MkDocs

添加功能¶

数学公式¶

两个方法：

• MathJax：功能更强
• KaTeX：速度更快

Markdown 扩展功能¶

增强的语法，参考 Python-Markdown、PyMdown Extensions。

评论系统¶

• Giscus参考资料：
  • Material for MkDocs: Adding a comment system
  • Giscus

Comments