本插件提供文档静态检查、预览、目录生成等工具，希望能提高文档贡献过程中开发体验。
开发指南 | 架构设计 | CHANGELOG
若您是文档的贡献者，想使用本插件，可阅读：
在 ascend 文档中使用 | 在 openEuler 文档中使用 | 在 openGauss 文档中使用
静态检查
配置说明
一键文档配置
一键开启相关文档配置，默认自定义检查配置。
选中相关配置后，只开启描述中的检查功能；若要自由开启检查功能，请选择自定义检查配置。
- 自定义检查配置：自定义开启检查功能
- 基础检查配置：开启 markdownlint、resource-existence-check、link-validity-check、tag-closed-check
- 远程检查配置：加载远程仓库的配置，请配置 docTools.a.remoteConfigUrl，如需指定某个具体配置，请配置 docTools.a.remoteConfigKey
- Ascend 文档检查配置：Ascend 文档检查配置，配置来源：https://raw.atomgit.com/Ascend/docs/raw/master/.doctools/config.json
- openEuler 文档检查配置：openEuler 文档检查配置，配置来源：https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/config.json
- openGauss 文档检查配置：openGauss 文档检查配置，配置来源：https://raw.atomgit.com/opengauss/docs/raw/common/.doctools/config.json
开启方法：
方法1：打开任意一篇 markdown -> 右下角状态栏 -> Doc Tools -> 选择对应的文档配置
远程配置
加载远程仓库的配置，可用于统一管理多个项目的文档检查配置。
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.a 或通过 settings.json 进行配置）：
检查范围
限制插件仅对路径包含特定目录名称的文件进行检查
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.scope 或通过 settings.json 进行配置）：
docTools.scope.enable
- 类型：
boolean
- 说明：检查范围限制：自定义检查配置 - 仅对路径包含特定目录名称的文件进行检查 （PS：此限制对批量检查无效）
- 默认：
false
docTools.scope.docPath
- 类型：
string
- 说明：检查范围限制：自定义检查配置 - 路径过滤正则表达式；需要 docTools.scope.enable 配置为 true 才会生效
- 默认：
docs?/(zh|en)?
配置示例
{
"docTools.scope.enable": false, // 启用检查范围仅限于 docs/zh 和 docs/en 目录，默认检查项目全局文档
"docTools.scope.docPath": "docs?/(zh|en)?" // 检查范围限制：路径过滤正则表达式，需要 docTools.scope.enable 配置为 true 才会生效
}
markdownlint
基于 Markdownlint 实现，帮助用户规范 Markdown 文档格式。
功能介绍
- 自动检测 Markdown 文件中的格式问题，如标题格式、列表缩进、空行等；
- 检查结果以警告（Warning）的形式在编辑器中高亮显示，并可在”问题”面板中查看详细信息；
- 可通过配置项灵活启用或禁用 lint 功能，并支持自定义 lint 规则，满足不同团队或个人的文档规范需求。
使用方法
- 安装并启用本插件，打开 Markdown 文件（
.md），插件会自动对文件内容进行 lint 检查；
- 检查结果会以警告（Warning）的形式显示在编辑器左侧和底部问题面板；
- 将光标悬停在警告标记上可查看详细的规则说明和建议。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.markdownlint或通过settings.json进行配置）：
docTools.markdownlint.enable
- 类型：
boolean
- 说明：markdownlint：自定义检查配置 - 启用检查
- 默认：
true
docTools.markdownlint.markdownlintRemoteConfigUrl
- 类型：
string
- 说明：markdownlint：自定义检查配置 - 远程 markdownlint 规则配置
- 默认：
https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/markdownlint.config.json
docTools.markdownlint.config
- 类型：
object
- 说明：markdownlint：本地 markdownlint 规则配置
- 默认：
{}
配置示例
{
"docTools.markdownlint.enable": true, // 是否开启功能
"docTools.markdownlint.markdownlintRemoteConfigUrl": "https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/markdownlint.config.json", // 远程 markdownlint 规则配置
"docTools.markdownlint.config": { // 本地 markdownlint 规则配置
"MD013": false, // 禁用行长度限制
"MD041": true // 启用标题必须为一级标题
}
}
规则说明
插件会拉取远程 markdownlint 规则配置，并使用本地规则配置覆盖远程规则配置进行 markdownlint 检查。
markdownlint 的规则配置可参考此 内容。
tag-closed-check
检查 Markdown 文件中的 Html 标签是否正确闭合，帮助用户避免因标签未闭合导致的渲染或语法错误。
功能介绍
- 自动检测 Markdown 文件中的 Html 标签是否正确闭合，包括未闭合、嵌套错误等问题；
- 支持快速修复功能，帮助用户一键修正标签闭合和转义问题；
- 支持通过配置项灵活启用或禁用该功能。
使用方法
- 安装并启用本插件，打开 Markdown 文件（
.md），插件会自动对文件内容进行 Html 标签闭合检查；
- 检查结果会以错误（Error）的形式在编辑器中高亮显示，并可在“问题”面板中查看详细信息；
- 将光标悬停在错误标记处，可查看错误详情；
- 可通过 VSCode 提供的 Quick Fix（快速修复）功能，点击灯泡图标或按下快捷键（通常为
Cmd+. 或 Ctrl+.），一键修复标签问题。
PS：在嵌套的 Html 标签（如 <table>xxx</table> 这种情况）里引发提示，请使用<和>字符替换 (适用于 Html 标签嵌套的情况)进行修复，其它情况请使用\字符替换 (适用于非 Html 标签嵌套的情况)进行修复。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.tagClosed或通过settings.json进行配置）：
docTools.check.tagClosed.enable
- 类型：
boolean
- 说明：tag-closed-check：自定义检查配置 - 启用 Html 标签闭合检查
配置示例
{
"docTools.check.tagClosed.enable": true
}
快速修复说明
- \字符替换：适用于非 Html 标签嵌套的情况，会在对应的 Html 标签前加上
\ 转义字符；
- <和>字符替换：适用于 Html 标签嵌套的情况，会将
< 和 > 替换为 < 和 >；
- 闭合标签：自动为未闭合的标签补全闭合部分。
link-validity-check
该插件用于在 VSCode 中检查 Markdown 文档中的链接有效性，帮助用户及时发现失效或错误的链接，提升文档质量。
功能介绍
- 自动扫描 Markdown 文档中的所有链接，包括以下三种格式：
[文本](https://github.com/opensourceways/vscode-doc-tools/blob/HEAD/链接) 形式的标准 Markdown 链接<http://example.com> 形式的裸链接<a href="链接"> 形式的 Html 链接
- 链接为 http 链接，支持跳过锚点链接（如
#section），并自动忽略链接中的锚点部分，仅校验主链接地址；
- 链接为相对路径的
.md 链接时，支持检测本地的 .md 文件是否存在，并且能够检查锚点是否有效；
- 对于无效链接，会在编辑器中以错误（Error）的形式在编辑器中高亮显示，并在问题面板中给出详细提示；
- 对于访问超时的链接，会在编辑器中以警告（Warning）的形式在编辑器中高亮显示，并在问题面板中给出详细提示；
- 支持通过配置项灵活启用或禁用该功能；
- 支持添加链接检查白名单（仅在链接为 http 链接会出现此修复功能）。
使用方法
- 安装并启用插件后，打开任意 Markdown 文件（
.md），插件会自动检测所有链接的有效性；
- 检查结果会以错误（Error）或警告（Warning）的形式显示在编辑器左侧和底部问题面板；
- 将光标悬停在错误或警告标记处，可查看错误详情；
- 若 http 链接确认可访问存在误报的情况，可通过 Quick Fix（快速修复）功能，将链接加入检查白名单。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.linkValidity或通过settings.json进行配置）：
docTools.check.linkValidity.enable
- 类型：
boolean
- 说明：link-validity-check：自定义检查配置 - 启用链接有效性检查（包含：1. 内链；2. 外链）
- 默认：
true
docTools.check.linkValidity.linkValidityCheckDisableExternalUrl
- 类型：
boolean
- 说明：link-validity-check：自定义检查配置 - 禁用外部链接检查
- 默认：
false
docTools.check.linkValidity.linkValidityCheckDisableInternalUrl
- 类型：
boolean
- 说明：link-validity-check：自定义检查配置 - 禁用内部链接检查
- 默认：
false
docTools.check.linkValidity.linkValidityCheckDisableAnchor
- 类型：
boolean
- 说明：link-validity-check：自定义检查配置 - 禁用锚点检查
- 默认：
false
docTools.check.linkValidity.linkValidityCheckDisableOnly404Status
- 类型：
boolean
- 说明：link-validity-check：自定义检查配置 - 禁用仅检查 404 链接
- 默认：
false
docTools.check.linkValidity.linkValidityCheckRemoteWhitelistUrl
- 类型：
string
- 说明：link-validity-check：自定义检查配置 - 远程白名单配置（添加后忽略对该链接的检查）
- 默认：
https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/url.whitelist.json
docTools.check.linkValidity.linkValidityCheckLocalWhiteList
- 类型：
array
- 说明：link-validity-check：本地白名单配置（添加后忽略对该链接的检查）
- 默认：
[]
配置示例
{
"docTools.check.linkValidity.enable": true,
"docTools.check.linkValidity.linkValidityCheckDisableExternalUrl": false,
"docTools.check.linkValidity.linkValidityCheckDisableInternalUrl": false,
"docTools.check.linkValidity.linkValidityCheckDisableAnchor": false,
"docTools.check.linkValidity.linkValidityCheckDisableOnly404Status": false,
"docTools.check.linkValidity.linkValidityCheckRemoteWhitelistUrl": "https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/url.whitelist.json",
"docTools.check.linkValidity.linkValidityCheckLocalWhiteList": []
}
注意事项
- 插件仅检测链接的格式和可达性，不保证目标内容的正确性；
- 某些私有或受限网络下的链接可能因网络原因被误判为无效；
- 对于本地文件链接，需确保路径正确且文件存在。
- 远程白名单和本地白名单会进行合并，最终生效的白名单配置为合并后的结果。
resource-existence-check
检查 Markdown 文件中的资源链接（如图片、视频等）是否存在，帮助用户及时发现无效或丢失的资源引用。
功能介绍
- 自动检测 Markdown 文件中的图片、视频等资源链接是否有效，包括 Markdown 语法和 Html 标签（如
<img>、<image>、<video>）中的资源路径；
- 支持多种资源引用方式，全面覆盖常见的资源链接格式；
- 对于无效或不存在的资源链接，会在编辑器中以错误（Error）形式提示用户，并在“问题”面板中列出详细信息；
- 对于访问超时的资源链接，会在编辑器中以警告（Warning）形式提示用户，并在“问题”面板中列出详细信息；
- 支持通过配置项灵活启用或禁用该功能；
- 支持添加链接检查白名单（仅在链接为 http 链接会出现此修复功能）。
使用方法
- 安装并启用本插件，打开 Markdown 文件（
.md），插件会自动检查文档中的资源链接有效性；
- 检查结果会以错误（Error）或警告（Warning）的形式在编辑器中高亮显示，并可在“问题”面板中查看详细信息；
- 将光标悬停在错误或警告标记处，可查看无效资源的具体路径和提示信息；
- 若 http 资源链接确认可访问存在误报的情况，可通过 Quick Fix（快速修复）功能，将链接加入检查白名单。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.resourceExistence 或通过 settings.json 进行配置）：
docTools.check.resourceExistence.enable
- 类型：
boolean
- 说明：resource-existence-check：自定义检查配置 - 启用资源有效性检查（包含：1. 内链；2. 外链）
- 默认：
true
docTools.check.resourceExistence.resourceExistenceCheckDisableExternalUrl
- 类型：
boolean
- 说明：resource-existence-check：自定义检查配置 - 禁用外部链接检查
- 默认：
false
docTools.check.resourceExistence.resourceExistenceCheckDisableInternalUrl
- 类型：
boolean
- 说明：resource-existence-check：自定义检查配置 - 禁用内部链接检查
- 默认：
false
docTools.check.resourceExistence.resourceExistenceCheckDisableOnly404Status
- 类型：
boolean
- 说明：resource-existence-check：自定义检查配置 - 禁用仅检查 404 资源链接
- 默认：
false
docTools.check.resourceExistence.resourceExistenceCheckRemoteWhitelistUrl
- 类型：
string
- 说明：resource-existence-check：自定义检查配置 - 远程白名单配置（添加后忽略对该链接的检查）
- 默认：
https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/url.whitelist.json
docTools.check.resourceExistence.resourceExistenceCheckLocalWhiteList
- 类型：
array
- 说明：resource-existence-check：本地白名单配置（添加后忽略对该链接的检查）
- 默认：
[]
配置示例
{
"docTools.check.resourceExistence.enable": true,
"docTools.check.resourceExistence.resourceExistenceCheckDisableExternalUrl": false,
"docTools.check.resourceExistence.resourceExistenceCheckDisableInternalUrl": false,
"docTools.check.resourceExistence.resourceExistenceCheckDisableOnly404Status": false,
"docTools.check.resourceExistence.resourceExistenceCheckRemoteWhitelistUrl": "https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/url.whitelist.json",
"docTools.check.resourceExistence.resourceExistenceCheckLocalWhiteList": []
}
toc-check
检查目录中链接的有效性，同时将检查每一篇文档是否已被包含在任意上级目录的 _toc.yaml 目录结构中，帮助用户及时发现和修正文档目录结构中的问题。
功能介绍
- 自动解析 TOC（目录）YAML 文件，递归收集所有链接（如
href、upstream），检查每个链接是否有效（即对应的文档是否存在于项目中）；
- 自动检测当前打开的 Markdown 文档是否已被加入到项目的
_toc.yaml 目录结构中。
使用方法
- 安装并启用本插件，打开包含 TOC 的 YAML 文件（如
toc.yaml），插件会自动对文件内容进行有效性检查以及该文件是否已被包含在当前目录或任意上级目录的 _toc.yaml 文件中；
- 检查结果会以错误（Error）的形式在编辑器中高亮显示，并可在“问题”面板中查看详细信息，同时，若文档未被目录包含，编辑器右下角会弹出提示信息，提醒用户将该文件加入
_toc.yaml；
- 将光标悬停在错误标记处，可查看错误详情。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.toc 或通过 settings.json 进行配置）：
配置示例
{
"docTools.check.toc.enable": false,
"docTools.check.toc.tocCheckDisableMdInToc": false
}
codespell-check
该插件用于在 VSCode 中检查 Markdown 文档中的单词拼写，帮助用户及时发现拼写错误，提升文档质量。
功能介绍
- 自动扫描 Markdown 文档中的文本内容，检测是否存在拼写错误的英文单词；
- 对于拼写错误的单词，会在编辑器中以提示（Info）的形式高亮显示，并在问题面板中给出详细提示；
- 支持通过配置项灵活启用或禁用该功能；
- 支持单词修正功能，用户可以根据提示选择正确的单词进行修正；
- 支持自定义忽略单词列表，用户可将特定单词加入白名单以避免误报。
使用方法
- 安装并启用插件后，打开任意 Markdown 文件（
.md），插件会自动检测文档中的单词拼写；
- 检查结果会以提示（Info）的形式在编辑器中高亮显示和在底部问题面板显示；
- 将光标悬停在提示标记处，可查看拼写错误详情；
- 可通过 Quick Fix（快速修复）功能，可以选择候选单词进行修改，或将拼写错误的单词添加到忽略列表。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.codespell 或通过 settings.json 进行配置）：
docTools.check.codespell.enable
- 类型：
boolean
- 说明：codespell-check：自定义检查配置 - 启用单词拼写检查
- 默认：
false
docTools.check.codespell.codespellCheckRemoteWhitelistUrl
- 类型：
string
- 说明：codespell-check：自定义检查配置 - 远程单词白名单配置（添加后忽略对该单词的检查）
- 默认：
https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/codespell.whitelist.json
docTools.check.codespell.codespellCheckLocalWhiteList
- 类型：
array
- 说明：codespell-check： 本地单词白名单配置（添加后忽略对该单词的检查）
- 默认：
[]
配置示例
{
"docTools.check.codespell.enable": false,
"docTools.check.codespell.codespellCheckRemoteWhitelistUrl": "https://raw.atomgit.com/openeuler/docs/raw/stable-common/.doctools/codespell.whitelist.json",
"docTools.check.codespell.codespellCheckLocalWhiteList": ["xxx"]
}
注意事项
- 插件主要检测英文单词拼写，对于中文等非拉丁文字符可能不适用；
- 某些专业术语或专有名词可能被误判为拼写错误，建议将其添加到忽略列表；
- 插件依赖于内置词典进行拼写检查，可能无法覆盖所有专业领域词汇。
- 远程白名单和本地白名单会进行合并，最终生效的白名单配置为合并后的结果。
file-naming-check
检查 Markdown 文件名/目录名的是否符合命名规范，提升文档管理质量。
功能介绍
- 支持检查 Markdown 文件名/目录名是否符合规范要求：需英文字母小写并且使用下划线连接单词；
- 对于不符合规范的文件名，会在 Markdown 文件打开时，右下角弹出提示；
- 支持通过配置项灵活启用或禁用相关功能；
使用方法
- 安装并启用插件后，在设置中勾选启用相关功能；
- 打开 Markdown 文件后，若文件名不符合规范，右下角会弹出提示。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.fileNaming 或通过 settings.json 进行配置）：
docTools.check.fileNaming.enable
- 类型：
boolean
- 说明：file-naming-check：自定义检查配置 - 启用文件/目录命名规范检查
- 默认：
false
配置示例
{
"docTools.check.fileNaming.enable": true,
}
注意事项
file-naming-consistency-check
检查中英文文档名称一致性。
功能介绍
- 支持检查中英文文档文件名是否一致，确保中英文文档一一对应；
- 当中英文文档文件名不一致时，会在 Markdown 文件打开时，右下角弹出提示；
- 支持通过配置项灵活启用或禁用相关功能；
使用方法
- 安装并启用插件后，在设置中勾选启用相关功能；
- 打开 Markdown 文件后，若中英文文档文件名不一致，右下角会弹出提示。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.fileNamingConsistency 或通过 settings.json 进行配置）：
docTools.check.fileNamingConsistency.enable
- 类型：
boolean
- 说明：file-naming-consistency-check：自定义检查配置 - 启用中英文文档名称一致性检查
- 默认：
false
配置示例
{
"docTools.check.fileNamingConsistency.enable": true
}
注意事项
punctuation-check
检查 Markdown 文档中的标点符号使用规范，帮助用户发现并纠正标点符号使用不当的问题，提升文档内容质量。
功能介绍
- 自动扫描 Markdown 文档中的文本内容，检测标点符号使用是否规范；
- 支持检查中英文标点符号混用问题，如中文文本中使用英文标点或英文文本中使用中文标点；
- 支持检查中文标点符号前后空格使用规范，中文标点前后不应有空格；
- 支持检查标点符号是否存在连续使用的情况；
- 支持检查手册/指南链接是否被书名号包裹；
- 支持中英文标点符号是否配对；
- 支持启用中文文字之间多余空格；
- 对于不规范的标点符号使用，会在编辑器中以提示（Info）的形式高亮显示，并在问题面板中给出详细提示；
- 支持通过配置项灵活启用或禁用相关功能。
使用方法
- 安装并启用插件后，在设置中勾选启用相关功能；
- 打开任意 Markdown 文件（
.md），插件会自动检测文档中的标点符号使用情况；
- 检查结果会以提示（Info）的形式在编辑器中高亮显示和在底部问题面板显示；
- 将光标悬停在提示标记处，可查看标点符号使用不规范的详情。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.check.punctuation 或通过 settings.json 进行配置）：
docTools.check.punctuationSpaces.enable
- 类型：
boolean
- 说明：punctuation-check：自定义检查配置 - 启用标点符号前后无空格检查（因语句含义复杂，可能存在误报）
- 默认：
false
docTools.check.punctuationMixing.enable
- 类型：
boolean
- 说明：punctuation-check：自定义检查配置 - 启用中英文标点符号混用检查（因语句含义复杂，可能存在误报）
- 默认：
false
docTools.check.punctuationConsecutive.enable
- 类型：
boolean
- 说明：punctuation-check：自定义检查配置 - 启用连续标点符号检查（因语句含义复杂，可能存在误报）
- 默认：
false
docTools.check.punctuationManualLink.enable
- 类型：
boolean
- 说明：punctuation-check：自定义检查配置 - 启用手册/指南链接是否被书名号包裹检查（因语句含义复杂，可能存在误报）
- 默认：
false
docTools.check.punctuationPair.enable
- 类型：
boolean
- 说明：punctuation-check：自定义检查配置 - 启用中英文标点符号是否配对检查（因语句含义复杂，可能存在误报）
- 默认：
false
docTools.check.extraSpaces.enable
- 类型：
boolean
- 说明：punctuation-check：自定义检查配置 - 启用中文文字之间无空格检查（因语句含义复杂，可能存在误报）
- 默认：
false
配置示例
{
"docTools.check.punctuationSpaces.enable": false,
"docTools.check.punctuationMixing.enable": false,
"docTools.check.punctuationConsecutive.enable": false,
"docTools.check.punctuationManualLink.enable": false,
"docTools.check.punctuationPair.enable": false,
"docTools.check.extraSpaces.enable": false
}
注意事项
- 检查默认关闭，如需要相关功能请到设置中开启；
- 因语句含义复杂，存在误报的情况。
其它工具
预览 Markdown
功能介绍
- 支持将某一本手册的 Markdown 预览成 openEuler 文档风格的页面；
- 支持保存后刷新预览页面；
- 支持从预览页面打开对应的 Markdown 文件或 _toc.yaml 文件。
使用方法
- 打开 Markdown 文件；
- 在编辑器右上角点击
D 字图标打开预览页面；
- 修改保存 Markdown 文件后会刷新预览页面；
- 修改关联的 _toc.yaml 文件后会刷新预览页面。
注意事项
- 只支持手册级别的预览；
- 如果预览的 Markdown 文件没有加入 _toc.yaml 文件，则不会显示菜单。
生成手册 _toc.yaml
功能介绍
- 自动生成目录：根据实际存在的 Markdown 文件，自动生成 _toc.yaml，避免手动维护目录结构；
- 同步标题：自动读取每个 Markdown 文件的一级标题（# ），作为目录项的 label；
- 去除无效项：如果 _toc.yaml 中的某些 href 指向的文件不存在，会自动移除这些无效项。
使用方法
- 安装并启用本插件；
- 右键点击对应目录：选择菜单
Doc Tools，再选择生成手册 _toc.yaml选项，便会在目标目录下自动生成或更新_toc.yaml。
注意事项
- 只有带有一级标题（# 标题）的 Markdown 文件才会被收录；
批量收集链接上下文
功能介绍
- 批量收集链接：扫描选中目录下的所有 Markdown 文件，收集其中出现的所有链接；
- 上下文展示：显示每个链接前后100个字符的内容，便于理解链接使用场景；
- 导出功能：支持将收集到的链接及其上下文导出到 Excel 文件。
使用方法
- 安装并启用本插件；
- 右键点击对应目录：选择菜单
Doc Tools，再选择批量收集链接上下文选项，打开 webview 页面；
- 在 webview 页面中点击
开始扫描按钮，开始批量收集链接；
- 扫描完成后，可查看链接及其上下文；
- 点击
导出到 Excel按钮，将结果导出到 Excel 文件。
批量收集样例代码
功能介绍
- 批量收集样例代码：扫描选中目录下的所有 Markdown 文件，从包含“样例”或“示例”的文档中，收集指向代码仓库（github.com、gitee.com、gitcode.com、atomgit.com 的
tree/blob/raw 路径）的样例代码链接；
- 兜底提示：若文档中未收集到样例代码链接，但存在 12 行及以上的代码块，也会作为疑似样例进行提示；
- 自动忽略：自动跳过指向
README.md、CHANGELOG、CONTRIBUTING.md、LICENSE 等仓库说明文件，以及 .md、.json、.yaml 后缀的链接；
- 白名单：支持将误报内容加入白名单，后续扫描将忽略；
- 导出功能：支持将收集结果导出到 Excel 文件。
使用方法
- 安装并启用本插件；
- 右键点击对应目录：选择菜单
Doc Tools，再选择 批量收集样例代码 选项，打开 webview 页面；
- 在 webview 页面中点击
开始扫描 按钮，开始批量收集；
- 扫描完成后，可查看收集到的样例代码链接，确认误报的内容可点击
加入白名单；
- 点击
导出数据 按钮，将结果导出到 Excel 文件。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.collectDemoCode 或通过 settings.json 进行配置）：
docTools.collectDemoCode.whiteList
- 类型：
array
- 说明：批量收集样例代码 - 白名单（加入后忽略对该内容的收集）
- 默认：
[]
注意事项
- 批量收集会递归遍历选中目录下的所有 Markdown 文件，文件数量较多时可能需要一定处理时间；
- 仅收集指向上述代码仓库的链接，普通外链不在收集范围内。
批量扫描未写链接内容
功能介绍
- 批量扫描未写链接内容：扫描选中目录下的所有 Markdown 文件，查找应当添加链接却未添加链接的内容；
- 支持识别以下两类情况：
- 使用书名号《》包裹的内容（如手册、指南名称），但其所在句子中未提供对应链接；
- 出现“参照、参见、参考、详见、点击查看、使用前准备”等引导词，但其后内容不是链接；
- 智能跳过：当“参照/参见/参考/详见”后紧跟“以下、如下、下面、下表、下图”等指代词，或位于句末时，不会上报；
- 排除范围：已有链接、图片、代码块、行内代码、标题、frontmatter 等区域不参与检查；
- 白名单：支持将误报内容加入白名单，后续扫描将忽略；
- 导出功能：支持将扫描结果导出到 Excel 文件。
使用方法
- 安装并启用本插件；
- 右键点击对应目录：选择菜单
Doc Tools，再选择 批量扫描未写链接内容 选项，打开 webview 页面；
- 在 webview 页面中点击
开始扫描 按钮，开始批量扫描；
- 扫描完成后，可查看未写链接的内容及其上下文，确认误报的内容可点击
加入白名单；
- 点击
导出数据 按钮，将结果导出到 Excel 文件。
配置说明
插件支持以下配置项（可在 VSCode 设置中搜索 docTools.scanNoLinkContent 或通过 settings.json 进行配置）：
docTools.scanNoLinkContent.whiteList
- 类型：
array
- 说明：批量扫描未写链接内容 - 白名单（加入后忽略对该内容的扫描）
- 默认：
[]
注意事项
- 批量扫描会递归遍历选中目录下的所有 Markdown 文件，文件数量较多时可能需要一定处理时间；
- 因语句含义复杂，可能存在误报，请结合上下文判断，并善用白名单。
生成链接锚点并复制
功能介绍
- 将选中的文本生成锚点并复制到剪贴板，方便后续使用。
使用方法
- 安装并启用本插件；
- 打开任意 Markdown 文件（
.md）；
- 选中标题文本；
- 右击编辑区域；
- 选择菜单
Doc Tools，再选择生成链接锚点并复制选项。
注意事项
- 生成的锚点适用于 Vitepress 页面的锚点跳转；
- 通常情况下和大多数 Markdown 预览（如 vscode 编辑器自带的 Markdown 预览）的锚点跳转一致，但在内容有一些符号的情况下存在一些差异，可能导致锚点在非 Vitepress 构建出的页面下不能跳转。
批量文档检查
功能介绍
- 对选中目录下的所有 Markdown 文件一次性执行多项检查；
- 支持的检查项由当前配置中
ci 字段决定，包括：markdownlint、tag-closed-check、link-validity-check、resource-existence-check、toc-check、codespell-check、file-naming-check、file-naming-consistency-check；
- 通过页面的方式呈现检查结果，仅展示存在问题的文件及各检查项的错误数量。
使用方法
- 安装并启用本插件；
- 确保已完成插件配置（需先设置检查配置）；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择 批量文档检查 选项；
- 在打开的页面中勾选需要执行的检查项；
- 点击
开始检查 按钮，等待扫描完成；
- 点击结果中的文件名可跳转至对应文件；
- 导出结果可点击
导出数据。
注意事项
- 需要先完成插件配置，否则无法启动检查；
- 批量检查会递归遍历选中目录下的所有 Markdown 文件，文件数量较多时可能需要一定处理时间；
- 页面只展示有错误的文件，无错误的文件不会出现在结果列表中；
- 可在扫描过程中点击
停止 终止检查。
markdownlint：批量执行 Markdown 语法检查
功能介绍
- 对选中目录下的所有 Markdown 文件执行 Markdownlint；
- 通过页面的方式呈现检查结果，清晰展示错误信息。
使用方法
- 安装并启用本插件；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择markdownlint：批量执行 Markdown 语法检查选项；
- 在打开的页面点击
开始检查；
- 导出结果可点击
导出数据。
注意事项
- 批量执行会递归遍历选中目录下的所有 Markdown 文件，可能需要一些处理时间。
tag-closed-check：批量执行 Html 标签闭合检查
功能介绍
- 支持批量检查选中目录下的 Markdown 文件中的 Html 标签闭合情况；
- 通过页面的方式呈现检查结果，清晰展示错误信息。
使用方法
- 安装并启用本插件；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择tag-closed-check：批量执行 Html 标签闭合检查选项；
- 在打开的页面点击
开始检查；
- 导出结果可点击
导出数据。
注意事项
- 批量检查会递归遍历选中目录下的所有 Markdown 文件，可能需要一些处理时间。
link-validity-check：批量执行链接有效性检查
功能介绍
- 检查选中目录下所有 Markdown 涉及链接是否可以正常访问；
- 通过页面的方式呈现检测结果。
使用方法
- 安装并启用本插件；
- 右键点击对应目录：选择菜单
Doc Tools，再选择link-validity-check：批量执行链接有效性检查选项；
- 在打开的页面勾选配置，点击
开始检查；
- 导出结果可点击
导出数据。
注意事项
- 某些私有或受限网络下的链接可能因网络原因被误判为无效，请以实际访问为准；
resource-existence-check：批量执行资源有效性检查
功能介绍
- 检查选中目录下所有 Markdown 涉及资源否可以正常访问；
- 通过页面的方式呈现检测结果。
使用方法
- 安装并启用本插件；
- 右键点击对应目录：选择菜单
Doc Tools，再选择resource-existence-check：批量执行资源有效性检查选项；
- 在打开的页面勾选配置，点击
开始检查；
- 导出结果可点击
导出数据。
注意事项
- 某些私有或受限网络下的链接可能因网络原因被误判为无效，请以实际访问为准；
toc-check：批量执行 Toc 检查
功能介绍
- 支持批量检查选中目录下的 _toc.yaml 文件是否有错误；
- 通过页面的方式呈现检查结果，清晰展示 _toc.yaml 文件的错误信息。
使用方法
- 安装并启用本插件；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择toc-check：批量执行 Toc 检查选项；
- 在打开的页面点击
开始检查；
- 导出结果可点击
导出数据。
注意事项
- 批量检查会递归遍历选中目录下的所有 _toc.yaml 文件，可能需要一些处理时间。
codespell-check：批量执行单词拼写检查
功能介绍
- 对选中目录下的所有 Markdown 文件执行单词拼写检查；
- 通过页面的方式呈现检查结果，清晰展示错误信息；
使用方法
- 安装并启用本插件；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择codespell-check：批量执行单词拼写检查选项；
- 在打开的页面点击
开始检查；
- 导出结果可点击
导出数据；
复制所有错误单词可将出现的错误单词复制到剪贴板，单词用\n换行符分隔，方便后续处理；所有错误单词加入白名单可将出现的错误单词一键加入本地白名单。
注意事项
- 批量执行会递归遍历选中目录下的所有 Markdown 文件，可能需要一些处理时间；
file-naming-check：批量执行目录和文件是否符合命名规范检查
功能介绍
- 支持批量检查选中目录下所有文件和子目录的命名规范：英文字母小写并使用下划线连接单词；
- 通过页面形式呈现检查结果，方便用户处理命名不规范的文件。
使用方法
- 安装并启用本插件；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择file-naming-check：批量执行目录和文件是否符合命名规范检查选项；
- 在打开的页面中查看检查结果，了解哪些文件或目录命名不规范；
- 根据提示信息修改不符合规范的文件名或目录名；
- 导出结果可点击
导出数据。
注意事项
- 批量检查会遍历选中目录下的所有文件和子目录，可能需要一些处理时间；
- 修改文件名或目录名后请同步更改其他文档中的相关链接。
file-naming-consistency-check：批量执行 Markdown 中英文文档名称是否一致检查
功能介绍
- 支持批量检查选中目录下中英文文档的文件名一致性；
- 通过页面的方式呈现检查结果，清晰展示缺少对应语言版本的文档。
使用方法
- 安装并启用本插件；
- 在资源管理器中右键点击需要检查的目录；
- 选择菜单
Doc Tools，再选择file-naming-consistency-check：批量执行 Markdown 中英文文档名称是否一致检查选项；
- 在打开的页面中查看检查结果，了解哪些文档缺少对应语言版本；
- 根据提示信息创建缺失的文档或修正不一致的文件名；
- 导出结果可点击
导出数据。
注意事项
- 批量检查会遍历选中目录下的所有 Markdown 文件，可能需要一些处理时间；
- 修改文件名后请同步更改其他文档中的相关链接。
