Markdown 校验器 免费在线 Markdown Lint 工具

在输入时根据 50 多条 markdownlint 规则检查你的 Markdown,然后一键修复问题。免费、私密:一切都在你的浏览器中运行。

Markdown 编辑器
校验结果0

你的文本永远不会离开浏览器。lint 使用官方 markdownlint 库在本地运行,不会上传或存储到我们的服务器。

什么是 Markdown 校验器?

Markdown 校验器(也称 Markdown linter)会分析你的 Markdown 源码,并报告违反样式和正确性规则的地方:跳级的标题、不一致的列表标记、行尾空格、硬制表符、裸 URL、没有语言的代码围栏,以及数十种其他问题。干净、一致的 Markdown 在 GitHub、静态站点生成器和转换器中都能可预期地渲染,也让文档的 diff 易于审阅。

本工具内嵌 markdownlint,即 Node.js 事实上的标准 Markdown lint 引擎,完全在你的浏览器中运行。它应用与 markdownlint-cli2、VS Code markdownlint 扩展以及无数 CI 流水线相同的默认规则集(MD001–MD059),因此这里通过的,在那里也能通过。修复问题按钮会应用该库的自动修复,等同于 markdownlint-cli2 --fix

如何分 3 步在线校验 Markdown

无需安装,无需账户:直接开始输入。

1

输入或粘贴 Markdown

在左侧编辑器中书写,或粘贴现有的 .md 文档,例如 GitHub README。

2

查看问题

lint 结果实时显示,带行号、规则 ID 和文档链接。点击某个问题即可跳转到它所在的行。

3

自动修复

一键修复每个可自动修复的问题:与 markdownlint-cli2 --fix 行为相同。

为什么使用我们的 Markdown Lint 工具?

值得信赖的 markdownlint 引擎,封装于快速的浏览器工具中。

50 多条 markdownlint 规则

markdownlint-cli2 和 VS Code 扩展所使用的完整默认规则集(MD001-MD059)。

输入时即时 lint

问题实时更新,带行号、规则 ID 以及指向官方规则文档的链接。

一键自动修复

自动修复行尾空格、列表标记、空行等,如同 markdownlint-cli2 --fix。

编辑器内标记

有问题的行会在 Ace 编辑器行槽中标出。点击任一问题即可直接跳转。

100% 私密

lint 完全在你的浏览器中使用官方 markdownlint 库运行。不上传任何内容。

与 CI 一致的结果

在默认设置下,与 markdownlint 在 GitHub Actions 和 CI 流水线中报告的结果一致。

常见的 markdownlint 检查规则

本校验器所应用的 50 多条规则中的一部分。每个规则 ID 都链接到官方文档。

标题

  • MD001
    heading-increment 标题级别每次只应递增一级
  • MD018
    no-missing-space-atx ATX 样式标题的井号后没有空格
  • MD022
    blanks-around-headings 标题前后应有空行
  • MD025
    single-h1 同一文档中存在多个顶级标题
  • MD026
    no-trailing-punctuation 标题末尾有标点
  • MD041
    first-line-heading 文件的第一行应为顶级标题

列表

  • MD004
    ul-style 无序列表样式应保持一致
  • MD005
    list-indent 同级列表项的缩进不一致
  • MD007
    ul-indent 无序列表缩进
  • MD029
    ol-prefix 有序列表项前缀
  • MD030
    list-marker-space 列表标记后的空格
  • MD032
    blanks-around-lists 列表前后应有空行

空白

  • MD009
    no-trailing-spaces 行尾空格
  • MD010
    no-hard-tabs 硬制表符
  • MD012
    no-multiple-blanks 多个连续空行
  • MD013
    line-length 行长不应超过 80 个字符
  • MD047
    single-trailing-newline 文件应以单个换行符结尾

代码、链接及其他

  • MD031
    blanks-around-fences 围栏代码块前后应有空行
  • MD034
    no-bare-urls 使用了裸 URL 而非链接
  • MD040
    fenced-code-language 围栏代码块应指定语言
  • MD042
    no-empty-links 不应有空链接
  • MD045
    no-alt-text 图片应有替代文本(alt)
  • MD058
    blanks-around-tables 表格前后应有空行

常见问题

关于在线 Markdown 校验器你需要了解的一切。

什么是 Markdown 校验器?

Markdown 校验器(或 Markdown linter)会根据一组样式和正确性规则检查你的 Markdown 源码,标记诸如跳级标题、不一致的列表标记、行尾空格、硬制表符以及缺少语言的代码块等问题。本工具运行与流行的 markdownlint 库相同的规则引擎。

这个 Markdown lint 工具检查哪些规则?

它运行完整的默认 markdownlint 规则集,即 MD001 到 MD059 共 50 多条规则,涵盖标题结构、列表格式、空白、代码块、链接、图片和表格。每条结果都链接到官方规则文档。

它能自动修复 Markdown 问题吗?

可以。点击“修复”按钮即可自动解决每个可修复的问题,例如行尾空格、标题周围缺失的空行、裸 URL 和不一致的列表标记,与 markdownlint-cli2 的 --fix 选项行为相同。

我的 Markdown 会上传到服务器吗?

不会。校验完全在你的浏览器中使用官方 markdownlint JavaScript 库运行。你的文本永远不会离开你的设备,因此适合处理私密或机密文档。

这与 markdownlint 和 markdownlint-cli2 相同吗?

本工具内嵌了驱动 markdownlint-cli2、VS Code markdownlint 扩展以及成千上万 CI 流水线的同一个 markdownlint 规则引擎,因此结果与这些工具在默认配置下报告的一致。

我为什么要 lint 我的 Markdown 文件?

一致的 Markdown 在 GitHub、文档生成器和转换器中渲染得更可预期,也让代码审阅中的 diff 保持整洁。lint 能捕捉细微问题,例如跳级的标题或缺失的空行,这些问题可能悄悄破坏渲染。

这个 Markdown 校验器免费吗?

是的,完全免费,无需注册,无限制。你可以校验任意数量的文档。

Markdown 干净了?预览它或导出为 PDF

实时查看你已校验的 Markdown 的渲染效果,或数秒内将其转换为专业排版的 PDF:免费且无水印。

实时 Markdown 预览