简体中文
EnglishMarkdown Tools 生成的 Markdown 兼容 GitHub、GitLab、Obsidian 等平台吗?
更新时间
兼容，但需要按目标平台选择对应工具，不能一概而论。Markdown Tools 的多数工具以 GFM（GitHub Flavored Markdown）为基准，任务列表、表格、数学公式等语法在 GitHub、GitLab、Obsidian 上通常可直接使用；但提示框（Callout/Admonition）这类各平台语法互不兼容的元素，工具会要求你先选定平台再生成。目录锚点则明确按 GitHub/Jekyll 风格输出。因此，判断兼容性的关键是：你用的是哪一类工具、目标平台是哪一个。
哪些工具的输出可以直接跨平台使用
以下工具生成的是通用 Markdown 或 GFM 语法，粘贴到 GitHub、GitLab、Obsidian 一般都能正常渲染：
| 工具 | 输出内容 | 兼容性说明 |
|---|---|---|
| 清单/任务列表生成器 | - [ ] 与 - [x] 语法 |
GFM 标准任务列表，GitHub、GitLab、Obsidian 均支持 |
| 表格格式化器 | 对齐后的 Markdown 表格 | 标准管道表格语法，跨平台通用 |
| 嵌套列表/缩进格式化器 | 统一缩进的列表 | 修正混用 Tab/空格、缩进宽度不一致的问题，输出为规范 Markdown |
| 字数与阅读时间 | 统计结果 | 不产生 Markdown，无兼容性问题 |
| 图片格式化器 | 带尺寸、对齐、图注的 HTML | 依赖平台是否允许内联 HTML，GitHub 与多数静态站点支持，部分严格渲染器可能过滤 |
任务列表和表格是最稳妥的一类：只要目标平台支持 GFM，基本不会出问题。
需要先选平台的工具
提示框/警告框生成器
这是兼容性差异最明显的工具。GitHub、GitLab、Obsidian、MkDocs、Docusaurus 各自使用不同且互不兼容的提示框语法，工具本身也明确提示了这一点。使用时的正确做法是：先在工具中选择目标平台，再生成对应语法，然后粘贴到该平台。把为 GitHub 生成的提示框贴到 Obsidian，通常不会渲染成提示框，而是显示为普通文本或原始标记。
数学公式预览
工具支持用 $inline$ 和 $$block$$ 写 LaTeX，并通过 KaTeX 实时预览。它的定位是“粘贴到 GitHub、GitLab 或 Obsidian 之前先确认渲染效果”。需要注意，预览用的是 KaTeX，而目标平台可能使用不同的渲染引擎或配置，个别复杂公式仍建议在目标平台上再确认一次。
Mermaid 图表预览
可以实时渲染 Mermaid 图，并复制为 Markdown 代码围栏，或导出 SVG/PNG。对于不支持 Mermaid 渲染的平台，导出图片是更稳的替代方案。
目录与锚点的兼容边界
目录生成器输出嵌套的 Markdown 目录，锚点采用 GitHub/Jekyll 风格，并且会处理重复标题的 slug。这意味着：
- 在 GitHub Pages、Jekyll 站点、GitHub 仓库内，锚点通常可直接跳转。
- 在 Obsidian 等使用不同内部链接机制的平台上，目录文本仍可用，但锚点跳转行为可能与 GitHub 不一致，需要实际点一遍验证。
一个具体的验证流程
以“给 GitHub 仓库写 README，同时同步到 Obsidian 笔记库”为例：
- 用编辑器写正文，侧边实时预览确认排版。
- 用任务列表生成器产出
- [ ]清单，用表格格式化器整理表格——这两类两边都能用。 - 提示框部分：为 GitHub 生成一次，为 Obsidian 单独生成一次，不要共用同一段。
- 用目录生成器生成 GitHub 风格目录，粘贴后在 GitHub 上点击验证锚点；同步到 Obsidian 时检查跳转是否正常。
- 有公式或 Mermaid 图时，先用预览工具确认，再分别粘贴到两个平台各看一次。
选择建议
- 只用一个平台：直接用对应平台的专用生成器（提示框、目录），兼容性最省心。
- 多平台同步同一份文档：优先使用 GFM 通用语法（任务列表、表格、标准标题），把提示框、目录锚点这类平台相关元素留到发布前按平台分别生成。
- 目标平台不支持 Mermaid 或内联 HTML：改用工具的导出功能（SVG/PNG）或简化语法。
工具页面本身强调“在浏览器中运行、无需安装”，但具体每个工具对哪些平台语法做了适配，仍以各工具页面上的平台选项和说明为准。