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.
MkDocs provides support for the following Markdown elements.
Element | Support | Notes |
---|---|---|
标题 | 支持 | |
段落 | 支持 | |
换行符 | 支持 | |
粗体 | 支持 | |
斜体 | 支持 | |
块引用 | 支持 | |
有序列表 | 支持 | |
无序列表 | 支持 | |
代码块 | 支持 | |
水平分隔符 | 支持 | |
链接 | 支持 | |
图片 | 支持 | |
表格 | 支持 | |
围栏代码块 | 支持 | |
语法高亮 | 支持 | |
脚注 | 不支持 | |
标题 ID | 不支持 | |
定义列表 | 不支持 | |
删除线 | 不支持 | |
任务列表 | 不支持 | |
Emoji (复制和粘贴) | 未知 | |
Emoji (简码) | 未知 | |
强调 | 不支持 | |
下标 | 不支持 | |
上标 | 不支持 | |
Automatic URL Linking | 支持 | |
Disabling Automatic URL Linking | 支持 | |
HTML | 支持 |
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 教程。我们不会发送垃圾邮件!