# Markdown 规范检查器 检查 Markdown 风格问题：标题层级、代码围栏、列表一致性等（零依赖规则引擎） > 标准页面: https://elysiatools.com/zh/tools/markdown-linter - **分类:** Development - **关键词:** markdown, linter, lint, 规范, 检查, 验证, 标题层级 ## 概述 Markdown 规范检查器是一款在线工具，旨在帮助开发者和创作者快速检测 Markdown 文档中的风格与格式问题。它支持检查标题层级、代码围栏、列表一致性等常见规范，并提供标准、宽松和严格三种规则集，帮助您一键生成清晰的文本或 JSON 格式的诊断报告。 ## 输入项 - **Markdown 输入** (textarea): Paste your Markdown to lint... - **规则集** (select) - **报告格式** (select) ## 适用场景 - 在将 Markdown 文档提交到 Git 仓库或发布到技术博客前，需要确保排版格式统一。 - 团队协作编写技术文档时，用于统一不同成员的 Markdown 编写风格。 - 检查长篇 Markdown 文件中是否存在标题层级跳跃、代码块未闭合或列表符号混用等排版错误。 ## 工作原理 - 将需要检查的 Markdown 文本粘贴到输入框中。 - 根据排版要求选择合适的规则集（标准、宽松或严格），并选择报告输出格式（文本或 JSON）。 - 规则引擎自动解析文档结构，实时输出包含错误行号、规则名称及修改建议的诊断报告。 ## 使用案例 - 技术文档预审：在发布 API 文档或开源项目 README 之前，快速定位排版缺陷。 - 博客文章排版校对：检查自媒体或个人博客的 Markdown 稿件，确保标题和列表格式美观一致。 - 自动化 CI 脚本集成测试：通过生成 JSON 格式的报告，配合脚本在本地或 CI 流程中验证文档规范性。 ## 常见问题 ### 这个检查器会修改我的 Markdown 文件吗？ 不会。它仅对输入的文本进行静态分析并输出诊断报告，不会自动修改或覆盖您的原始文本。 ### 标准、宽松和严格规则集有什么区别？ 标准规则集适用于大多数通用场景；宽松规则集忽略一些非关键的空格或换行限制；严格规则集则对标题层级顺序、列表缩进和代码块格式有极高要求。 ### 什么是标题层级跳跃？ 标题层级跳跃是指在没有二级标题（H2）的情况下直接使用三级标题（H3），这会破坏文档的逻辑大纲结构。 ### 为什么我的代码块被标记为警告？ 通常是因为代码围栏（如 ```）没有指定具体的编程语言标识符，或者未正确闭合。 ### 诊断报告支持哪些格式输出？ 支持直观易读的文本报告格式，以及便于程序解析和集成到自动化工作流中的 JSON 格式。 ## 相关工具 - [Markdown 链接检查器](https://elysiatools.com/zh/tools/markdown-link-checker): 静态检查 Markdown 链接的格式错误、悬空锚点和未定义引用（不发起网络请求） - [批量URL验证器](https://elysiatools.com/zh/tools/batch-url-validator): 一次性验证多个URL，包含格式检查和安全分析 - [邮箱批量验证器](https://elysiatools.com/zh/tools/batch-email-validator): 一次性验证多个邮箱地址，包含格式检查和基本质量分析 - [Markdown 规范与风格检查器](https://elysiatools.com/zh/tools/markdown-lint-style-checker): 按约 15 条 markdownlint 规则加 2 条中文排版规则检查 Markdown，给出带行号的问题清单，并可一键自动修复安全项 - [批量电话验证器](https://elysiatools.com/zh/tools/batch-phone-validator): 一次性验证和格式化多个电话号码，支持国际格式 - [Data URI 生成器](https://elysiatools.com/zh/tools/data-uri-generator): 将文件转换为 Data URI（Base64 或百分号编码），用于直接在 HTML、CSS 或 Markdown 中内联图片、字体等资源 - [维持液量计算器（4-2-1 法则）](https://elysiatools.com/zh/tools/fluid-maintenance-rate): 按 Holliday-Segar 4-2-1 法则计算每小时维持液量：首 10 kg 4 mL/kg/h，次 10 kg 2 mL/kg/h，>20 kg 1 mL/kg/h。同时给出日总量（×24）和 100/50/20 mL/kg/day 日热量法交叉验证。4-2-1 是禁食或不能口服液体的正常容量患者的起始估算，需根据发热、烧伤、丢失、SIADH、心/肾功能不全调整。儿童 <10 kg 时两种方法完全一致；>20 kg 时小时法略高于日总量法。来源 Holliday-Segar Pediatrics 1957、MDCalc、Meyers 2009。不构成医疗建议。 - [Markdown链接提取器](https://elysiatools.com/zh/tools/markdown-link-extractor): 从Markdown文档中提取内联链接、引用链接和纯URL，并进行基本语法验证 ## 示例 - [Markdown 幻灯片示例](https://elysiatools.com/zh/samples/md-slide-deck-to-pdf): 用于测试 PDF 导出的 Remark/Marp 风格 Markdown 幻灯片 - [Markdown 示例](https://elysiatools.com/zh/samples/markdown-samples): Markdown 格式示例，从简单到复杂的文档结构 - [Markdown 查看器样本](https://elysiatools.com/zh/samples/markdown-viewer-samples): 用于 README 预览、文档渲染和富文本标记测试的 Markdown 样本文件 - [PDF示例](https://elysiatools.com/zh/samples/pdf-samples): 2026-02-01 到 2026-02-10 工具生成的PDF示例 ## 相关内容 - [代码压缩、美化与格式化工具](https://elysiatools.com/zh/hubs/code-minify-beautify-format-tools): 用可读格式或紧凑输出准备代码和标记，并检查语法与内容保真。