Markdown 格式校验与自动修复 · 一键修正格式错误

粘贴或导入 Markdown,一键自动修复格式问题,输出规范的 .md 文件。

可以用来做什么?

检查文档格式规范

自动发现标题层级错误、空格缺失等常见 Markdown 问题

提交前校验文档

开发者在合并 PR 前用 lint 检查 Markdown 文档质量

统一团队写作风格

配置统一规则,确保多人协作文档风格一致

一键自动修复问题

检查后自动修复可修复的格式问题,减少手动调整

清理历史文档

对旧文档批量检查并修复格式,提升文档库整体质量

学习 Markdown 规范

通过 lint 提示学习标准 Markdown 写法,养成良好书写习惯

如何使用?

1

输入 Markdown

粘贴或上传需要检查的 Markdown 文档

2

运行格式检查

自动检测格式问题,列出错误位置和修复建议

3

修复并导出

一键修复可自动修正的问题,下载规范化后的文档

相关工具推荐

Markdown 编辑器

不知道 .md 文件怎么打开?直接拖入浏览器即可查看和编辑。在线 Markdown 编辑器,左侧编辑右侧实时预览,支持代码高亮、图片插入、暗色模式。草稿自动保存本地,隐私 100% 不上传。

Mermaid 图表

在线 Mermaid (流程图) 图表编辑器,输入 Mermaid 语法即时预览流程图、时序图、类图、ER 图、甘特图、饼图。支持导出 SVG / PNG,纯浏览器本地运行,代码不上传,支持中英文示例。

LaTeX 公式

在线 LaTeX 公式编辑器,输入 LaTeX 代码即时预览渲染效果,支持希腊字母、积分、矩阵等快捷符号插入,导出 SVG / PNG,纯浏览器本地运行,代码不上传。

MD 分享链接

粘贴 Markdown 文档,生成一条可分享的在线预览链接,对方无需安装任何工具即可查看完整排版效果。链接 7 天后自动失效,数据不上传服务器。

HTML 转 MD

把任意 HTML — 网页源码、微信公众号文章、博客复制、富文本编辑器内容 — 粘贴进来,转成干净的 GFM Markdown。自动清理内联样式、规整表格、代码块、引用块和图片链接。100% 浏览器本地,没有任何上传。

MD 转公众号

面向已经在 Obsidian / VSCode / Typora 写稿的 Markdown 创作者:把 .md 内容粘贴进来,右侧是真实公众号样式的实时预览,复制后直接粘贴进公众号编辑器,所有格式都保留。支持本地图片上传:在 Markdown 中引用的本地图片路径会自动识别,上传后保存到浏览器 IndexedDB,刷新页面也不丢失;也可直接拖入含图片的 ZIP 包或文件夹。代码高亮、引用块、表格都按公众号能识别的样式渲染。

文本对比

免费在线文本对比工具,逐行比较两段文本的差异,高亮显示新增、删除和修改内容。支持代码对比。

查看更多

常见问题

基于 markdownlint 规则,可自动修复:① 标题 # 号后缺少空格(##标题 → ## 标题)② 标题前后缺少空行 ③ 行尾多余空格 ④ 有序列表全部写成 1.(自动修为 1. 2. 3. 递增)⑤ 列表标记后空格数量不对 ⑥ 文件末尾缺少换行 ⑦ 硬 Tab 缩进转换为空格。以上均可一键处理,不会改变内容含义。注意:markdownlint 默认允许全用 1. 的写法,本工具已显式开启递增校验。

遇到其它问题或建议? 有 bug 或建议?点击发邮件给我们。

邮件我们

Markdown 格式规范为什么这么重要?

Markdown 的优势在于用纯文本表达结构,但这也带来一个隐患:不同工具对"格式容忍度"差异极大。GitHub 会把 ##标题(# 号后无空格)渲染成普通段落;markdownlint、Vale、CI 流水线会把行尾空格当成 lint 错误;pandoc 导出 PDF 时,标题前缺少空行会导致层级坍塌。

这些问题在源头不起眼,但在团队协作、版本控制、多平台发布中会形成连锁反应:PR 里出现大量无意义的空格 diff、CI 格式检查失败让发布卡住、同一份 .md 在不同渲染器里呈现不一致……提前把格式修干净,既是对自己稿件的负责,也是对下游工具链的尊重。

MeTool 的 Markdown 格式校验与自动修复工具,基于业界最广泛使用的 markdownlint 规则集,在浏览器本地运行 — 内容不离开设备,适合处理内部草稿和未公开内容。

自动修复能处理的 7 类常见格式问题

① 标题 # 号后缺少空格(MD018 / MD019)

很多人习惯打 ##标题,在浏览器预览里看起来没问题,但严格的渲染器会把它当成普通文本。自动修复会在 # 号后插入规范的空格:## 标题

② 标题前后缺少空行(MD022)

标题紧跟在正文后面不换行,在一些渲染器和导出工具里会导致标题与上文"粘"在一起,层级错乱。自动修复会在标题前后各插入一个空行。

③ 行尾多余空格(MD009)

行尾空格在 Markdown 里有特殊含义(两个空格 = 强制换行),但无意的尾随空格会造成 Git diff 噪音、CI lint 失败。自动修复会清除无意义的尾随空格。

④ 有序列表序号格式不一致(MD029)

有些编辑器或复制粘贴场景会让有序列表全写成 1. 1. 1.,GitHub 能渲染,但 Word / PDF 导出工具可能会混乱。自动修复会让序号变成 1. 2. 3. 标准递增。

⑤ 列表标记后空格不对(MD030)

规范要求 - 后跟一个空格,有些工具会产生两个或零个空格。自动修复统一为单空格。

⑥ 文件末尾缺少换行(MD047)

POSIX 标准要求文本文件末尾有换行符。缺少换行会导致 Git 提示 "No newline at end of file",多人协作时容易产生不必要的 diff。

⑦ 硬 Tab 缩进(MD010)

代码块外的 Tab 字符在不同渲染器里宽度不一致。自动修复将 Tab 替换为 4 个空格(Markdown 缩进标准)。

什么时候用格式修复,什么时候用 Prettier?

两个工具定位不同:

  • 本工具(markdownlint 修复):只修复明确的格式违规,不重写内容。适合"帮我把这份别人发来的 .md 修干净"场景,改动最小,不会意外折行或改变排版意图。
  • Prettier:风格统一工具,会对整个文档做再排版 — 折行宽度(默认 80 字符)、标点前后空格、列表缩进全部重新整理。适合团队 CI 中强制统一风格,但改动较大,不适合"只想修几个 lint 错误"。

建议工作流:先用本工具修复格式错误 → 再用 Markdown 编辑器做内容润色 → 最后发布到 公众号 / PDF

在 CI / Pre-commit Hook 里做格式检查

本工具专为"随时修一篇 .md"的手动场景设计。如果你管理的是一个 Markdown 文档库或文档站点,建议配合以下方案做自动化保障:

  • markdownlint-cli2:在本地或 CI 里运行 markdownlint-cli2 "**/*.md",--fix 参数自动修复可修复项,退出码非 0 时让 CI 失败。
  • pre-commit hook:配合 husky + lint-staged,提交前自动对 changed .md 文件运行 markdownlint --fix,只拦截有问题的提交。
  • GitHub Actions:在 PR 里添加 markdownlint-cli2 step,让格式检查成为合并门控的一部分。

上述方案都基于与本工具相同的规则集,浏览器端的修复结果和 CI 端完全一致。