MkDocs is a static site generator designed for building documentation websites. Written in the Python programming language, MkDocs is an open-source project with a lot of community support. A variety of themes are available. In terms of Markdown support, MkDocs does an excellent job supporting the basic syntax elements, but it lacks support for some extended syntax elements.

The application uses the Python-Markdown Markdown processor. You can enable additional extensions.

A newly deployed MkDocs site.

MkDocs Markdown 支持

MkDocs provides support for the following Markdown elements.

Element Support Notes
标题 支持
段落 支持
换行符 支持
粗体 支持
斜体 支持
块引用 支持
有序列表 支持
无序列表 支持
代码块 支持
水平分隔符 支持
链接 支持
图片 支持
表格 支持
围栏代码块 支持
语法高亮 支持
脚注 不支持
标题 ID 不支持
定义列表 不支持
删除线 不支持
任务列表 不支持
Emoji (复制和粘贴) 未知
Emoji (简码) 未知
强调 不支持
下标 不支持
上标 不支持
Automatic URL Linking 支持
Disabling Automatic URL Linking 支持
HTML 支持

Using Admonitions

Here’s a handy feature: You can enable an extension to use admonitions in MkDocs. This is a quick and easy way to start using notes, warnings, and tips on your MkDocs site. See this GitHub issue for more information and examples.

另请参阅

想了解更多 Markdown 技巧?

现在不要停下来!在下面输入你的电子邮件地址,以通过电子邮件接收新的 Markdown 教程。我们不会发送垃圾邮件!