Markdown 可移植性预检
粘贴 Markdown 源码，查看哪些结构在不同环境中显示不同或失效：例如 GitHub、严格 CommonMark 渲染器或旧版 Reddit 等精简渲染器。
在您的浏览器中本地处理。文件绝不会被上传。
使用方法 工具
- 粘贴 Markdown 源码或完整 README/文档；文本在浏览器中处理，不会发送。
- 选择“检查可移植性”。
- 查看每个标记结构为何不可移植，以及哪些渲染器存在差异。
- 仅在提供时使用建议改写；多数问题若不猜测意图就无法自动修复，工具会解释原因。
假设条件
- 识别七类特定结构：裸 URL、制表符缩进代码块、GFM 管道表格、GFM 删除线、GFM 任务列表、没有匹配定义的引用式链接/图片，以及含常被过滤标签的原始 HTML 块。其他 Markdown 渲染行为不在范围内。
- 这是按行分析的文本扫描器，不是完整 Markdown 解析器：不会构建文档树，并会有意跳过围栏代码块内的内容。
- 仅当粘贴文档中完全没有对应引用标签定义时，才标记引用链接/图片；按 CommonMark 规则匹配时不区分大小写。
来源与参考数据
方法说明
跟踪并排除围栏代码块后，用针对性模式匹配定位每类结构，再依据 GitHub Flavored Markdown、CommonMark 规范和常见精简渲染器之间有文档记录的差异进行检查。只有机械上安全且无歧义时才提供改写，例如用尖括号包住裸 URL。不会为缺失引用定义编造目标，也不会静默改写有效且有意使用的 GFM 表格、任务列表或删除线。
计算示例
没有尖括号或链接语法的裸 URL
输入项: 请参阅 https://example.com 了解详情。
结果: GFM 会自动将其转换为链接；严格 CommonMark 可能将其保留为不可点击的普通文本。标记为警告，并可安全改写为“请参阅 <https://example.com> 了解详情。”
没有匹配定义的引用式链接
输入项: 升级前请阅读 [迁移指南][missing-ref]。
结果: 文档中不存在 `[missing-ref]: url` 定义，因此所有渲染器都会将其显示为字面语法或损坏链接。这是真正错误，而非可移植性差异。标记为错误，不编造目标 URL。
GFM 管道表格
输入项: | 姓名 | 年龄 | |------|-----| | Ada | 30 |
结果: 管道表格是 GitHub Flavored Markdown 扩展，不属于核心 CommonMark。CommonMark 渲染器可能将管道符和横线显示为普通文本，而不是表格。
实用指南
- 文档可能由严格 CommonMark 渲染时，将裸 URL 用尖括号括起，或转换为完整的 `[文本](url)` 链接。
- 优先使用围栏代码块（```），而非制表符或空格缩进代码块；它们没有制表符宽度歧义，也更易被后续编辑者识别。
- 发布前检查每个引用式链接/图片的目标和标签；缺失或拼错定义是真正错误，不是显示差异。
- 面向公开平台的 Markdown 避免使用原始 `<script>`、`<iframe>`、`<style>`、`<object>` 和 `<embed>` 标签；内容被过滤是常见预期行为。
常见错误
- 因为表格或任务列表在 GitHub 上显示正常，就认为到处都能用；GFM 扩展不属于 CommonMark 规范。
- 将损坏的引用链接当作可移植性问题而非错误；与其他提示不同，定义缺失会使所有渲染器中的链接都失败。
常见问题
为什么裸 URL 只是警告，而损坏的引用链接是错误？
裸 URL 在所有地方仍是可读文本，即使没有自动成为链接也不会丢失内容。损坏的引用链接在所有渲染器中都会显示为字面方括号语法或缺失链接，是功能性错误。
为什么工具不把 GFM 表格或任务列表改写成更可移植的形式？
没有能保留相同含义和外观的严格可移植形式；纯 CommonMark 没有表格或复选框概念。工具会标记其依赖 GFM，让你决定目标阅读环境是否接受，而不是猜测并改变内容结构。
工具会检查围栏代码块中的内容吗？
不会。围栏代码块中的文本按字面显示，不作为 Markdown 语法解释，因此会被有意跳过。代码围栏中示例用的裸 URL 或 `~~删除线~~` 不构成实际可移植性问题。
为什么 Markdown 表格在 GitHub 显示、在 CommonMark 却不显示？
管道表格是 GitHub Flavored Markdown 扩展，不属于核心 CommonMark。只实现 CommonMark 的渲染器可能将管道符和分隔行显示为文本。本预检识别该差异，但不渲染或比较所有 Markdown 实现。
上次审核： 2026-09-25
这是有限的按行扫描器，不是完整 Markdown 解析器：仅识别七类结构，不分析嵌套强调歧义、脚注、自动链接边界情况或 HTML 实体处理等其他 CommonMark/GFM 边界情况。也无法知道损坏引用链接原本想指向哪里；只报告错误，不猜修复目标。
此工具 根据上述假设提供参考估算值。
主题和工具偏好设置，以及已保存和最近使用的列表仅存储在此浏览器中。