# Markdown 规范与风格检查器

按约 15 条 markdownlint 规则加 2 条中文排版规则检查 Markdown，给出带行号的问题清单，并可一键自动修复安全项

> 标准页面: https://elysiatools.com/zh/tools/markdown-lint-style-checker

- **分类:** Text Processing

- **关键词:** markdown, lint, 检查, 风格, 规范

## 概述

粘贴 Markdown，得到内容质量报告——而非结构转换。检查器把文档切分为块（标题、列表、代码围栏、表格…），运行受 markdownlint 启发的规则引擎，覆盖：

markdownlint 规则：
- MD001 标题递增（不跳级）
- MD003 / MD006 标题样式与位置
- MD004 无序列表标记一致
- MD009 尾随空格
- MD012 连续多个空行
- MD013 行长度（严格）
- MD022 / MD031 / MD032 标题、代码围栏、列表周围的空行
- MD024 重复标题
- MD025 单个 h1
- MD029 有序列表前缀
- MD040 围栏代码语言
- MD041 首行为顶级标题
- MD042 空链接 / MD045 图片缺 alt
- MD047 尾随换行

中文排版规则：
- CN001：中文与拉丁/数字之间加空格（"使用 Python 3" 而非 "使用Python3"）。
- CN002（严格）：混合语境下的全角标点。

自动修复仅应用安全、确定性的修复：去除尾随空格、折叠空行、在标题/围栏/列表周围插入空行、将列表标记统一为 "-"、补充尾随换行。需人工复核的问题（标题层级、缺语言）只列出，从不自动改动。

规则集：
- 默认：15 条 markdownlint 规则 + 2 条中文规则。
- 严格：增加行长度（MD013）、有序列表前缀、setext 标题检查。
- 宽松：仅错误，抑制风格警告。

## 输入项

- **Markdown 内容** (textarea): # Title Some Markdown with issues... - item one * item two (mixed markers) ``` code without language ``` ##使用Python3 (missing space)
- **规则集** (select)
- **自动修复安全项** (checkbox)

## 适用场景

- 在发布技术文档、README 或博客文章前，需要确保 Markdown 语法正确且排版整洁时。
- 团队协作编写文档时，需要统一标题层级、列表标记和中英文混排的空格规范时。
- 需要快速批量修复 Markdown 文件中的尾随空格、多余空行或缺失的末尾换行等常见格式问题时。

## 工作原理

- 粘贴需要检查的 Markdown 文本，并根据需求选择“默认”、“严格”或“宽松”规则集。
- 检查器将文档切分为标题、列表、代码块等不同区块，并运行规则引擎进行逐行扫描。
- 系统输出带行号的问题清单，若开启了自动修复，将直接应用安全规则并输出修正后的 Markdown 文本。

## 使用案例

- 开源项目维护者在合并 PR 前，对 README.md 进行规范性检查与自动格式化。
- 技术作家在发布中文技术教程前，自动纠正中英文混排缺失空格（CN001）的问题。
- 团队文档库管理，通过严格模式统一所有 Markdown 文件的标题样式与列表前缀。

## 常见问题

### 自动修复功能会修改我的文档内容吗？

不会。自动修复仅应用于去除尾随空格、折叠空行、规范列表标记等安全且确定性的格式调整，不会改动文字内容或标题层级。

### 什么是 CN001 中文排版规则？

该规则要求在中文与拉丁字母或数字之间添加空格（例如将“使用Python3”规范为“使用 Python 3”），以提升阅读体验。

### 严格、默认和宽松规则集有什么区别？

默认包含 15 条 markdownlint 和 2 条中文规则；严格版增加了行长度和有序列表前缀检查；宽松版则仅保留错误提示，忽略风格警告。

### 为什么有些检测到的问题没有被自动修复？

诸如标题跳级（MD001）或代码块缺少语言标注（MD040）等问题需要人工确认，因此不会进行自动修改，仅在报告中列出。

### 该工具支持哪些 Markdown 语法元素的检查？

支持检查标题层级、无序与有序列表、代码围栏、空链接、图片 alt 属性、尾随空格及换行等。

## 相关工具

- [Markdown链接提取器](https://elysiatools.com/zh/tools/markdown-link-extractor): 从Markdown文档中提取内联链接、引用链接和纯URL，并进行基本语法验证
- [缩进列表转 ASCII 目录树](https://elysiatools.com/zh/tools/ascii-tree-from-indented-list): 把 2 空格 / 4 空格 / Tab 缩进的层级列表（Markdown bullet、- * 1. 前缀可选）渲染为可复制的 ASCII 目录树。支持 Unicode 方框与经典 ASCII 两种风格，以及整根纵线、行尾空格、叶节点方括号等开关。
- [安全响应头检查器](https://elysiatools.com/zh/tools/security-headers-checker): 审计 HTTP 响应头的安全合规性——解析你粘贴的原始头（无网络），按 OWASP 安全头集做值级检查：HSTS max-age、CSP unsafe-inline/eval、X-Content-Type-Options、Referrer-Policy、Permissions-Policy、COOP/COEP/CORP 等。输出字母评级（A+ 到 F）及逐项 Finding 与可复制的修复建议。
- [血气酸碱失衡判读（AG / ΔAG 联合分析）](https://elysiatools.com/zh/tools/blood-gas-anion-gap): 对动脉血气进行系统性酸碱失衡判读，结合阴离子间隙（AG）和 delta-delta（ΔAG/ΔHCO₃⁻）检测混合性酸碱紊乱。步骤：①pH 分层（酸血症/正常/碱血症）；②原发紊乱识别（代酸/代碱/呼酸/呼碱）；③代偿检查（Winter 公式 PaCO₂=1.5×HCO₃+8±2、急/慢性呼酸碱的 HCO₃ 变化规则）；④AG = Na−Cl−HCO₃（±白蛋白校正）；⑤Delta ratio：<0.4 正常 AG 代酸，0.4–0.8 混合，1–2 纯高 AG 代酸，>2 高 AG 代酸+代碱。不同于已有的 anion-gap-calculator（仅算血清 AG），本工具做完整血气判读。来源 Emmett 2016、Kraut CJASN 2007、Rastegar 2007、LITFL、MDCalc、Adrogué NEJM 1998。不构成医疗建议。
- [甲状腺激素指数（TSH/FT4/FT3 联动判读）](https://elysiatools.com/zh/tools/thyroid-index): 联动判读 TSH、FT4 与可选 FT3，判断甲状腺轴状态。成人参考范围：TSH 0.4–4.0 mIU/L、FT4 0.8–1.8 ng/dL（≈10–23 pmol/L）、FT3 2.3–4.2 pg/mL（≈3.5–6.5 pmol/L）。TSH 高 + FT4 低 → 原发性甲减（桥本、消融后、缺碘、胺碘酮/锂）；TSH 高 + FT4 正常 → 亚临床甲减；TSH 低 + FT4 高（±FT3 高）→ 原发性甲亢（Graves、毒性结节、甲状腺炎早期、碘/胺碘酮相关）；TSH 低 + FT4 正常 → 亚临床甲亢或外源性激素或早期甲状腺炎，应查 FT3 识别 T3 毒症；TSH 正常/低 + FT4 低 → 中枢性（继发/三发）甲减（垂体/下丘脑病变）；TSH 高 + FT4 高 → TSH 瘤或甲状腺激素抵抗；全部正常 → 甲状腺功能正常（非甲状腺病态综合征可仅 FT3 低）。注意事项：TSH 昼夜节律（22:00–02:00 峰，午后谷）；多巴胺、激素、重病、卡麦角林可抑制 TSH；孕期应使用孕期特异性 TSH 范围；异嗜性抗体可致假性 TSH/FT4 异常；胺碘酮可致 1 型（碘致）与 2 型（破坏性）甲亢。来源 ATA 2014/2016、NACB 2002、Garber 2012、MDCalc。不构成医疗建议。
- [平水韵 / 词林正韵 古典诗词韵部索引](https://elysiatools.com/zh/tools/ping-shui-yun-ci-lin-zheng-yun-classical-chinese-poetry-rhyme-index): 输入汉字或短语,查询其平水韵 106 韵部与词林正韵 19 部归属、四声与平仄,输出平仄谱与押韵判断;反查韵部列出全部字表,并附李白、杜甫、苏轼、李清照、岳飞名篇韵脚出处。
- [AI 域名创意生成器](https://elysiatools.com/zh/tools/ai-domain-name-idea-generator): 输入品牌关键词,让 AI 生成最多 10 个创意域名,自动用 DNS 粗筛 + RDAP 复验可用性,过滤掉已注册的。面向创业者、独立开发者、品牌策划。
- [色彩空间转换器](https://elysiatools.com/zh/tools/color-space-converter): 在 HEX、RGB、HSL、CIELAB 与 Display-P3 之间转换颜色，提供 CSS 输出与色域检查。

## 示例

- [Markdown 查看器样本](https://elysiatools.com/zh/samples/markdown-viewer-samples): 用于 README 预览、文档渲染和富文本标记测试的 Markdown 样本文件
- [Markdown 示例](https://elysiatools.com/zh/samples/markdown-samples): Markdown 格式示例，从简单到复杂的文档结构
- [Markdown 幻灯片示例](https://elysiatools.com/zh/samples/md-slide-deck-to-pdf): 用于测试 PDF 导出的 Remark/Marp 风格 Markdown 幻灯片
- [Test Pyramid Examples - 测试策略指导](https://elysiatools.com/zh/samples/test-pyramid-examples): 全面的测试金字塔实现示例，包括单元测试、集成测试、端到端测试、测试组织和平衡软件质量保证的战略测试模式

## 相关内容

- [编辑文案审校与品牌语气复核](https://elysiatools.com/zh/hubs/editorial-copy-review-and-brand-voice): 在不抹平作者原意的前提下，复核现有稿件的品牌语气、标题、可读性、排版空白和 Markdown 质量。