Material for MkDocs 中 Python Markdown 扩展的完整配置指南【免费下载链接】mkdocs-materialDocumentation that simply works项目地址: https://gitcode.com/GitHub_Trending/mk/mkdocs-materialMaterial for MkDocs 的核心写作体验建立在 Python Markdown 及其扩展体系之上Markdown 本身是一门非常精简的语言而 Python Markdown 扩展正是补齐表格、脚注、缩写、提示框、属性列表等技术写作所需语法的关键。本文以 docs/setup/extensions/python-markdown.md 为骨架逐一拆解 Material for MkDocs 官方支持的全部 Python Markdown 扩展的启用方式、配置项、默认值与实战用法并结合本仓库 mkdocs.yml 的真实配置给出可直接复制的完整配置方案。读完本文你将能独立为任意 MkDocs 项目搭建一套结构完整、语法丰富、可直接投入技术写作的 Markdown 扩展环境。Python Markdown 扩展在 Material for MkDocs 中的定位Markdown 由 John Gruber 提出其参考实现功能极为克制。Material for MkDocs 选择了 Python Markdown 作为 Markdown 解析引擎并通过扩展机制为技术写作注入大量实用能力——从最基础的表格、目录到进阶的脚注、缩写、属性注入都在mkdocs.yml的markdown_extensions配置项下声明式启用。在 Material for MkDocs 中扩展体系分两个来源Python Markdown 官方扩展即本文重点包含abbr、admonition、attr_list、def_list、footnotes、md_in_html、toc、tables八个扩展全部开箱即用Python Markdown Extensionspymdownx另一个功能更丰富的扩展集合与前者互补见 docs/setup/extensions/python-markdown-extensions.md。二者的启用方式完全一致在mkdocs.yml的markdown_extensions列表下添加扩展名需要配置的扩展则写成带缩进的嵌套映射。本仓库 mkdocs.yml 中启用了本文涉及的全部官方扩展是观察这些扩展真实配置的最佳样本。支持的核心扩展详解Abbreviations为术语添加缩写与悬停解释Abbreviations 扩展允许为元素添加小型悬停提示即abbr标签。它仅支持纯文本不支持任何 Markdown 标记适用于解释缩写词、专业名词等场景。自版本 1.0.0 起支持无配置选项markdown_extensions: - abbr启用后即可在正文中定义缩写典型用法见 docs/reference/tooltips.md#adding-abbreviations若要构建全站统一术语表配合pymdownx.snippets的auto_append将缩写定义集中到一个独立文件建议放在docs目录之外实现见 docs/reference/tooltips.md#adding-a-glossary。本仓库的mkdocs.yml也通过pymdownx.snippets.auto_append将includes/mkdocs.md注入所有页面见 includes/mkdocs.md印证了这一模式在真实项目中的可行性。AdmonitionMarkdown 中的提示框Call-outsAdmonition 扩展自 0.1.0 起为文档引入提示框语法用极简单的标记即可生成note、tip、warning、danger等十余种样式的侧注块用于在不打断正文流的前提下补充旁注内容。无配置选项markdown_extensions: - admonition启用后使用!!!加类型限定符即可创建提示框还支持自定义标题、去除标题、嵌套与inline浮动布局等写法完整语法与 12 种内置类型note、abstract、info、tip、success、question、warning、failure、danger、bug、example、quote见 docs/reference/admonitions.md。若希望提示框可折叠???语法还需额外启用pymdownx.details扩展若希望提示框内能嵌入代码块等内容则需pymdownx.superfences三者组合的完整配置见 docs/reference/admonitions.md#configuration。Attribute Lists为任意元素注入 HTML 属性与 CSS 类Attribute Lists 扩展自 0.1.0 起允许通过特殊语法为几乎所有行内与块级元素添加 HTML 属性或 CSS 类。它是 Material for MkDocs 众多高级功能的基石无配置选项markdown_extensions: - attr_list启用后通过元素后紧跟{ ... }的方式注入属性例如{ alignleft }实现图片对齐、{ loadinglazy }实现图片懒加载见 docs/reference/images.md#image-alignment 与 docs/reference/images.md#image-lazy-loading{ .annotate }为块添加注解标记见 docs/reference/annotations.md#usage以及网格布局docs/reference/grids.md#using-grids、按钮docs/reference/buttons.md#adding-buttons、带颜色与动画的图标docs/reference/icons-emojis.md#with-colors、docs/reference/icons-emojis.md#with-animations等。需要留意的是该扩展存在已知限制并非所有元素都支持属性注入部分场景需借助md_in_html包裹一层 HTML 容器来解决这也是下方扩展的典型用途之一。Definition Lists定义列表Definition Lists 扩展自 1.1.0 起让 Markdown 支持 HTML 中dl定义列表的写法适合术语词典、参数说明等术语 解释成对出现的场景。无配置选项markdown_extensions: - def_list语法与示例见 docs/reference/lists.md#using-definition-lists。它通常与pymdownx.tasklist任务列表一起被列为列表扩展族的推荐组合完整列表配置参考 docs/reference/lists.md。Footnotes脚注引用与内容Footnotes 扩展自 1.0.0 起允许在文档中定义行内脚注渲染时自动集中显示在文档所有 Markdown 内容之后且自动生成返回引用链接。无配置选项markdown_extensions: - footnotes脚注引用写法为[^1]脚注内容写法为[^1]: ...多段内容需缩进四个空格详见 docs/reference/footnotes.md#adding-footnote-references 与 docs/reference/footnotes.md#adding-footnote-content。脚注同样可关联工具提示效果若启用content.footnote.tooltips主题特性悬停脚注即可就地预览内容参见 docs/reference/footnotes.md#footnote-tooltips。Markdown in HTML在 HTML 块中书写 MarkdownMarkdown in HTML 扩展自 0.1.0 起解决了一个关键痛点默认情况下 Markdown 会忽略原始 HTML 块级元素内部的所有内容启用该扩展后只要在 HTML 标签上添加markdown属性即可让标签内内容按 Markdown 解析。渲染时markdown属性会被剥离其余属性完整保留。无配置选项markdown_extensions: - md_in_htmldiv classannotate markdown 这段引用内的 Markdown 会被正常解析。 /div它是注解docs/reference/annotations.md#usage、网格docs/reference/grids.md#usage、图片题注docs/reference/images.md#image-captions等功能的必备依赖——当 Attribute Lists 无法覆盖某些元素如 blockquote时用md_in_html包裹是最可靠的兜底方案。Table of Contents文档目录唯一带配置项的官方扩展Table of Contents 扩展自 0.1.0 起根据文档标题自动生成目录Material for MkDocs 将其渲染为页面右侧的导航侧栏。与其他扩展不同它支持多达五个官方配置项markdown_extensions: - toc: permalink: truetitle自 7.3.5 起默认根据站点语言自动计算设置右侧目录栏的标题默认取自 docs/setup/changing-the-language.md#site-language 的翻译资源markdown_extensions: - toc: title: On this pagepermalink默认false在每个标题末尾添加一个锚点链接默认符号为段落符¶悬停时显示与读者当前看到的页面行为一致。可自定义符号 段落符 ¶ yaml markdown_extensions: - toc: permalink: true 锚点符 ⚓︎ yaml markdown_extensions: - toc: permalink: ⚓︎ permalink_title默认Permanent link设置锚点链接的悬停标题与屏幕阅读器读取的文本出于无障碍考虑建议改为更明确的描述markdown_extensions: - toc: permalink_title: Anchor link to this section for referenceslugify默认使用内置toc.slugify定制标题转 slug 的函数。默认实现针对部分语言可能生成可读性不佳的标识符此时可改用pymdownx.slugs提供的 Unicode 感知版本 Unicode yaml markdown_extensions: - toc: slugify: !!python/object/apply:pymdownx.slugs.slugify kwds: case: lower Unicode, case-sensitive yaml markdown_extensions: - toc: slugify: !!python/object/apply:pymdownx.slugs.slugify {} toc_depth默认6限定目录包含的标题层级范围。对标题层级很深的项目可收缩目录长度甚至完全移除目录 仅保留前 3 级 yaml markdown_extensions: - toc: toc_depth: 3 完全隐藏目录 yaml markdown_extensions: - toc: toc_depth: 0 注意该扩展的其他配置项未被 Material for MkDocs 官方支持使用它们可能产生意外结果需自担风险。TablesMarkdown 表格Tables 扩展自 0.1.0 起为 Markdown 引入表格语法通常默认已启用但显式声明更稳妥。无配置选项markdown_extensions: - tables表格对齐、数据表格的样式与用法见 docs/reference/data-tables.md#usage 与 docs/reference/data-tables.md#column-alignment。已被取代的扩展为何不再推荐Material for MkDocs 曾支持另两个官方扩展但因被功能更优的替代品取代如今不再推荐使用Fenced Code Blocks → 改用 SuperFencesFenced Code Blocks 提供围栏代码块语法但其能力被pymdownx.superfences全面超越——后者支持代码块的任意嵌套如代码块内嵌提示框、选项卡、列表等因此官方明确推荐迁移配置见 docs/setup/extensions/python-markdown-extensions.md#superfences。CodeHilite → 改用 HighlightCodeHilite 的代码高亮支持自版本 6.0.0 起被移除因为pymdownx.highlight与pymdownx.superfences、pymdownx.inlinehilite等核心扩展的集成更紧密、能力更完整。迁移配置见 docs/setup/extensions/python-markdown-extensions.md#highlight。从源码结构也可以印证这一方向本仓库源码目录 src/extensions/ 仅保留emoji.py与preview.py两个 Python Markdown 扩展挂钩官方高亮能力全部由 pymdownx 体系承担。配置实战从零搭建完整的扩展环境以下配置来自 docs/setup/extensions/index.md是官方给出的两套可直接复制的方案。最小配置——适合首次接触 Material for MkDocs 的用户先保证正文具备目录与代码高亮两项基础能力markdown_extensions: # Python Markdown - toc: permalink: true # Python Markdown Extensions - pymdownx.highlight - pymdownx.superfences推荐配置——完整启用 Material for MkDocs 的全部 Markdown 能力适合有经验的项目 bootstrapmarkdown_extensions: # Python Markdown - abbr - admonition - attr_list - def_list - footnotes - md_in_html - toc: permalink: true # Python Markdown Extensions - pymdownx.arithmatex: generic: true - pymdownx.betterem: smart_enable: all - pymdownx.caret - pymdownx.details - pymdownx.emoji: emoji_index: !!python/name:material.extensions.emoji.twemoji emoji_generator: !!python/name:material.extensions.emoji.to_svg - pymdownx.highlight - pymdownx.inlinehilite - pymdownx.keys - pymdownx.mark - pymdownx.smartsymbols - pymdownx.superfences - pymdownx.tabbed: alternate_style: true - pymdownx.tasklist: custom_checkbox: true - pymdownx.tilde如果你希望观察一套生产级配置本仓库自身的 mkdocs.yml 是最佳参考——它不仅启用了上述全部 Python Markdown 官方扩展还以带注释的方式演示了pymdownx.highlightanchor_linenums、line_spans、pygments_lang_class、pymdownx.superfencescustom_fences接入 Mermaid 图表等进阶选项的真实组合并展示了如何用not_in_nav、hooks等配套配置管理文档工程。小结扩展选型速查扩展版本起点配置选项核心用途配套参考abbr1.0.0无缩写与术语悬停提示docs/reference/tooltips.mdadmonition0.1.0无提示框 / Call-outsdocs/reference/admonitions.mdattr_list0.1.0无元素级 HTML 属性与 CSS 类docs/reference/annotations.mddef_list1.1.0无定义列表docs/reference/lists.mdfootnotes1.0.0无脚注引用与内容docs/reference/footnotes.mdmd_in_html0.1.0无HTML 块内解析 Markdowndocs/reference/images.mdtoc0.1.0title、permalink、permalink_title、slugify、toc_depth文档目录本页上文tables0.1.0无Markdown 表格docs/reference/data-tables.md八个官方扩展中toc是唯一提供丰富配置项的扩展其permalink、toc_depth、slugify对技术文档的阅读体验与 URL 可分享性影响最为直接其余扩展虽无配置项但作为 Material for MkDocs 高级特性注解、网格、按钮、图标、图片对齐的地基值得在项目中优先启用。而fenced_code_blocks与codehilite两个旧扩展则应明确放弃统一迁移到pymdownx.superfences与pymdownx.highlight体系。【免费下载链接】mkdocs-materialDocumentation that simply works项目地址: https://gitcode.com/GitHub_Trending/mk/mkdocs-material创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Material for MkDocs 中 Python Markdown 扩展的完整配置指南
Material for MkDocs 中 Python Markdown 扩展的完整配置指南【免费下载链接】mkdocs-materialDocumentation that simply works项目地址: https://gitcode.com/GitHub_Trending/mk/mkdocs-materialMaterial for MkDocs 的核心写作体验建立在 Python Markdown 及其扩展体系之上Markdown 本身是一门非常精简的语言而 Python Markdown 扩展正是补齐表格、脚注、缩写、提示框、属性列表等技术写作所需语法的关键。本文以 docs/setup/extensions/python-markdown.md 为骨架逐一拆解 Material for MkDocs 官方支持的全部 Python Markdown 扩展的启用方式、配置项、默认值与实战用法并结合本仓库 mkdocs.yml 的真实配置给出可直接复制的完整配置方案。读完本文你将能独立为任意 MkDocs 项目搭建一套结构完整、语法丰富、可直接投入技术写作的 Markdown 扩展环境。Python Markdown 扩展在 Material for MkDocs 中的定位Markdown 由 John Gruber 提出其参考实现功能极为克制。Material for MkDocs 选择了 Python Markdown 作为 Markdown 解析引擎并通过扩展机制为技术写作注入大量实用能力——从最基础的表格、目录到进阶的脚注、缩写、属性注入都在mkdocs.yml的markdown_extensions配置项下声明式启用。在 Material for MkDocs 中扩展体系分两个来源Python Markdown 官方扩展即本文重点包含abbr、admonition、attr_list、def_list、footnotes、md_in_html、toc、tables八个扩展全部开箱即用Python Markdown Extensionspymdownx另一个功能更丰富的扩展集合与前者互补见 docs/setup/extensions/python-markdown-extensions.md。二者的启用方式完全一致在mkdocs.yml的markdown_extensions列表下添加扩展名需要配置的扩展则写成带缩进的嵌套映射。本仓库 mkdocs.yml 中启用了本文涉及的全部官方扩展是观察这些扩展真实配置的最佳样本。支持的核心扩展详解Abbreviations为术语添加缩写与悬停解释Abbreviations 扩展允许为元素添加小型悬停提示即abbr标签。它仅支持纯文本不支持任何 Markdown 标记适用于解释缩写词、专业名词等场景。自版本 1.0.0 起支持无配置选项markdown_extensions: - abbr启用后即可在正文中定义缩写典型用法见 docs/reference/tooltips.md#adding-abbreviations若要构建全站统一术语表配合pymdownx.snippets的auto_append将缩写定义集中到一个独立文件建议放在docs目录之外实现见 docs/reference/tooltips.md#adding-a-glossary。本仓库的mkdocs.yml也通过pymdownx.snippets.auto_append将includes/mkdocs.md注入所有页面见 includes/mkdocs.md印证了这一模式在真实项目中的可行性。AdmonitionMarkdown 中的提示框Call-outsAdmonition 扩展自 0.1.0 起为文档引入提示框语法用极简单的标记即可生成note、tip、warning、danger等十余种样式的侧注块用于在不打断正文流的前提下补充旁注内容。无配置选项markdown_extensions: - admonition启用后使用!!!加类型限定符即可创建提示框还支持自定义标题、去除标题、嵌套与inline浮动布局等写法完整语法与 12 种内置类型note、abstract、info、tip、success、question、warning、failure、danger、bug、example、quote见 docs/reference/admonitions.md。若希望提示框可折叠???语法还需额外启用pymdownx.details扩展若希望提示框内能嵌入代码块等内容则需pymdownx.superfences三者组合的完整配置见 docs/reference/admonitions.md#configuration。Attribute Lists为任意元素注入 HTML 属性与 CSS 类Attribute Lists 扩展自 0.1.0 起允许通过特殊语法为几乎所有行内与块级元素添加 HTML 属性或 CSS 类。它是 Material for MkDocs 众多高级功能的基石无配置选项markdown_extensions: - attr_list启用后通过元素后紧跟{ ... }的方式注入属性例如{ alignleft }实现图片对齐、{ loadinglazy }实现图片懒加载见 docs/reference/images.md#image-alignment 与 docs/reference/images.md#image-lazy-loading{ .annotate }为块添加注解标记见 docs/reference/annotations.md#usage以及网格布局docs/reference/grids.md#using-grids、按钮docs/reference/buttons.md#adding-buttons、带颜色与动画的图标docs/reference/icons-emojis.md#with-colors、docs/reference/icons-emojis.md#with-animations等。需要留意的是该扩展存在已知限制并非所有元素都支持属性注入部分场景需借助md_in_html包裹一层 HTML 容器来解决这也是下方扩展的典型用途之一。Definition Lists定义列表Definition Lists 扩展自 1.1.0 起让 Markdown 支持 HTML 中dl定义列表的写法适合术语词典、参数说明等术语 解释成对出现的场景。无配置选项markdown_extensions: - def_list语法与示例见 docs/reference/lists.md#using-definition-lists。它通常与pymdownx.tasklist任务列表一起被列为列表扩展族的推荐组合完整列表配置参考 docs/reference/lists.md。Footnotes脚注引用与内容Footnotes 扩展自 1.0.0 起允许在文档中定义行内脚注渲染时自动集中显示在文档所有 Markdown 内容之后且自动生成返回引用链接。无配置选项markdown_extensions: - footnotes脚注引用写法为[^1]脚注内容写法为[^1]: ...多段内容需缩进四个空格详见 docs/reference/footnotes.md#adding-footnote-references 与 docs/reference/footnotes.md#adding-footnote-content。脚注同样可关联工具提示效果若启用content.footnote.tooltips主题特性悬停脚注即可就地预览内容参见 docs/reference/footnotes.md#footnote-tooltips。Markdown in HTML在 HTML 块中书写 MarkdownMarkdown in HTML 扩展自 0.1.0 起解决了一个关键痛点默认情况下 Markdown 会忽略原始 HTML 块级元素内部的所有内容启用该扩展后只要在 HTML 标签上添加markdown属性即可让标签内内容按 Markdown 解析。渲染时markdown属性会被剥离其余属性完整保留。无配置选项markdown_extensions: - md_in_htmldiv classannotate markdown 这段引用内的 Markdown 会被正常解析。 /div它是注解docs/reference/annotations.md#usage、网格docs/reference/grids.md#usage、图片题注docs/reference/images.md#image-captions等功能的必备依赖——当 Attribute Lists 无法覆盖某些元素如 blockquote时用md_in_html包裹是最可靠的兜底方案。Table of Contents文档目录唯一带配置项的官方扩展Table of Contents 扩展自 0.1.0 起根据文档标题自动生成目录Material for MkDocs 将其渲染为页面右侧的导航侧栏。与其他扩展不同它支持多达五个官方配置项markdown_extensions: - toc: permalink: truetitle自 7.3.5 起默认根据站点语言自动计算设置右侧目录栏的标题默认取自 docs/setup/changing-the-language.md#site-language 的翻译资源markdown_extensions: - toc: title: On this pagepermalink默认false在每个标题末尾添加一个锚点链接默认符号为段落符¶悬停时显示与读者当前看到的页面行为一致。可自定义符号 段落符 ¶ yaml markdown_extensions: - toc: permalink: true 锚点符 ⚓︎ yaml markdown_extensions: - toc: permalink: ⚓︎ permalink_title默认Permanent link设置锚点链接的悬停标题与屏幕阅读器读取的文本出于无障碍考虑建议改为更明确的描述markdown_extensions: - toc: permalink_title: Anchor link to this section for referenceslugify默认使用内置toc.slugify定制标题转 slug 的函数。默认实现针对部分语言可能生成可读性不佳的标识符此时可改用pymdownx.slugs提供的 Unicode 感知版本 Unicode yaml markdown_extensions: - toc: slugify: !!python/object/apply:pymdownx.slugs.slugify kwds: case: lower Unicode, case-sensitive yaml markdown_extensions: - toc: slugify: !!python/object/apply:pymdownx.slugs.slugify {} toc_depth默认6限定目录包含的标题层级范围。对标题层级很深的项目可收缩目录长度甚至完全移除目录 仅保留前 3 级 yaml markdown_extensions: - toc: toc_depth: 3 完全隐藏目录 yaml markdown_extensions: - toc: toc_depth: 0 注意该扩展的其他配置项未被 Material for MkDocs 官方支持使用它们可能产生意外结果需自担风险。TablesMarkdown 表格Tables 扩展自 0.1.0 起为 Markdown 引入表格语法通常默认已启用但显式声明更稳妥。无配置选项markdown_extensions: - tables表格对齐、数据表格的样式与用法见 docs/reference/data-tables.md#usage 与 docs/reference/data-tables.md#column-alignment。已被取代的扩展为何不再推荐Material for MkDocs 曾支持另两个官方扩展但因被功能更优的替代品取代如今不再推荐使用Fenced Code Blocks → 改用 SuperFencesFenced Code Blocks 提供围栏代码块语法但其能力被pymdownx.superfences全面超越——后者支持代码块的任意嵌套如代码块内嵌提示框、选项卡、列表等因此官方明确推荐迁移配置见 docs/setup/extensions/python-markdown-extensions.md#superfences。CodeHilite → 改用 HighlightCodeHilite 的代码高亮支持自版本 6.0.0 起被移除因为pymdownx.highlight与pymdownx.superfences、pymdownx.inlinehilite等核心扩展的集成更紧密、能力更完整。迁移配置见 docs/setup/extensions/python-markdown-extensions.md#highlight。从源码结构也可以印证这一方向本仓库源码目录 src/extensions/ 仅保留emoji.py与preview.py两个 Python Markdown 扩展挂钩官方高亮能力全部由 pymdownx 体系承担。配置实战从零搭建完整的扩展环境以下配置来自 docs/setup/extensions/index.md是官方给出的两套可直接复制的方案。最小配置——适合首次接触 Material for MkDocs 的用户先保证正文具备目录与代码高亮两项基础能力markdown_extensions: # Python Markdown - toc: permalink: true # Python Markdown Extensions - pymdownx.highlight - pymdownx.superfences推荐配置——完整启用 Material for MkDocs 的全部 Markdown 能力适合有经验的项目 bootstrapmarkdown_extensions: # Python Markdown - abbr - admonition - attr_list - def_list - footnotes - md_in_html - toc: permalink: true # Python Markdown Extensions - pymdownx.arithmatex: generic: true - pymdownx.betterem: smart_enable: all - pymdownx.caret - pymdownx.details - pymdownx.emoji: emoji_index: !!python/name:material.extensions.emoji.twemoji emoji_generator: !!python/name:material.extensions.emoji.to_svg - pymdownx.highlight - pymdownx.inlinehilite - pymdownx.keys - pymdownx.mark - pymdownx.smartsymbols - pymdownx.superfences - pymdownx.tabbed: alternate_style: true - pymdownx.tasklist: custom_checkbox: true - pymdownx.tilde如果你希望观察一套生产级配置本仓库自身的 mkdocs.yml 是最佳参考——它不仅启用了上述全部 Python Markdown 官方扩展还以带注释的方式演示了pymdownx.highlightanchor_linenums、line_spans、pygments_lang_class、pymdownx.superfencescustom_fences接入 Mermaid 图表等进阶选项的真实组合并展示了如何用not_in_nav、hooks等配套配置管理文档工程。小结扩展选型速查扩展版本起点配置选项核心用途配套参考abbr1.0.0无缩写与术语悬停提示docs/reference/tooltips.mdadmonition0.1.0无提示框 / Call-outsdocs/reference/admonitions.mdattr_list0.1.0无元素级 HTML 属性与 CSS 类docs/reference/annotations.mddef_list1.1.0无定义列表docs/reference/lists.mdfootnotes1.0.0无脚注引用与内容docs/reference/footnotes.mdmd_in_html0.1.0无HTML 块内解析 Markdowndocs/reference/images.mdtoc0.1.0title、permalink、permalink_title、slugify、toc_depth文档目录本页上文tables0.1.0无Markdown 表格docs/reference/data-tables.md八个官方扩展中toc是唯一提供丰富配置项的扩展其permalink、toc_depth、slugify对技术文档的阅读体验与 URL 可分享性影响最为直接其余扩展虽无配置项但作为 Material for MkDocs 高级特性注解、网格、按钮、图标、图片对齐的地基值得在项目中优先启用。而fenced_code_blocks与codehilite两个旧扩展则应明确放弃统一迁移到pymdownx.superfences与pymdownx.highlight体系。【免费下载链接】mkdocs-materialDocumentation that simply works项目地址: https://gitcode.com/GitHub_Trending/mk/mkdocs-material创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考