Elysia Tools
导航
Format Conversion
在 GitHub 风格 Markdown 与 AsciiDoc（Antora / Red Hat / Asciidoctor 文档系统的标准格式）之间互转：标题层级自动偏移（AD 的 = 是文档级标题）、链接方括号顺序自动翻转、围栏代码块 ⇄ [source] 块、GFM 管道表 ⇄ |=== 表、NOTE/TIP/WARNING 警示块、任务列表、脚注、交叉引用锚点、硬换行等全部覆盖，无法完美映射的构造会列出提示。
详情
转换器为无依赖的行级块解析器 + 行内标记词法分析，双向实现。核心规则：MD 的 #/## 映射到 AD 的 ==/===（除非把首个 H1 提升为 = 文档标题）；MD 文本 翻转为 AD URL[文本]，URL 含括号/下划线时用 ++…++ 透传包裹，避免下划线被误解析为斜体；``` 围栏 → [source,lang] + ----；GFM 管道表 → |=== 表，首行为 options="header" 表头，:--- 对齐写入 colspec；> 引用 → [quote] 块，带署名时生成 [quote, 作者]; NOTE:/TIP:/IMPORTANT:/WARNING:/CAUTION: ⇄ > [!NOTE] GitHub Alert 约定（输入端同时识别旧式 > Note 形式）；任务列表、脚注、[[锚点]] 与 <<交叉引用>>、硬换行（行尾两空格 ⇄ 行尾 +）、水平线（--- ⇄ '''）均支持。AD→MD 方向支持 include::/属性引用/条件预处理指令的注释化降级并给出提示。往返（round-trip）语义不承诺无损，重点是单次迁移的正确性。
执行
填写表单、运行工具，并在同一页面查看结果。
案例
相关内容
工具使用指南
Markdown ⇄ AsciiDoc 转换器是一款双向文档语法转换工具，支持在 GitHub 风格 Markdown（GFM）与 AsciiDoc 之间互转。它能精确处理标题层级映射、链接语法翻转、代码围栏、管道表格、警示块（Admonitions）以及任务列表等核心排版元素，并对无法无损映射的高级指令提供清晰提示。
背景
项目从 Markdown 静态站点迁移至基于 Antora 的 AsciiDoc 文档体系，需要转换现有的发布日志。
问题
包含一级标题、链接、任务列表、警告提示和 Python 代码块的 Markdown 文本需要手动调整大量语法符号。
如何使用
选择方向为“Markdown → AsciiDoc”，勾选“将首个 H1 提升为文档标题”，粘贴 Markdown 源码即可获取标准 AsciiDoc 格式。
方向: md2ad, 将首个 H1 提升为文档标题: true, 保留未映射标记并提示: true结果
H1 成功提升为 = 文档标题，链接转为 URL[文本]，代码块生成 [source,python] 容器，表格和警示块均符合 Asciidoctor 标准。
背景
维护者需要将已有的 AsciiDoc 文档模块内容同步到 GitHub 代码仓库的根目录作为说明文件。
问题
GitHub 原生渲染 Markdown 体验更好，需要将 |=== 表格、NOTE: 块和 link: 宏还原为 GFM 格式。
如何使用
选择方向为“AsciiDoc → Markdown”，将 AsciiDoc 文本粘贴到输入区，复制转换后的 Markdown 输出。
方向: ad2md, 将首个 H1 提升为文档标题: false, 保留未映射标记并提示: true结果
NOTE: 成功转为 GitHub 标准的 > [!NOTE] 提示框，|=== 表格还原为管道表格，代码块还原为三重反引号围栏。
AsciiDoc 的单个等号（=）代表文档级标题，开启提升首个 H1 选项后 Markdown 的 # 转为 =，## 转为 ==；关闭时 # 默认对应 ==。
Markdown 的 [文本](URL) 会翻转为 AsciiDoc 的 URL[文本]；若 URL 包含括号或下划线，会自动用 ++...++ 透传包裹以避免格式冲突。
支持，Markdown 中的 > [!NOTE] 或 > **Note** 会被转换为 AsciiDoc 的 NOTE: 块，反向转换同样支持。
在转为 Markdown 时，include:: 指令、属性引用和条件编译会降级为 HTML 注释保留，并附带转换提示。
支持，GFM 表格的分隔行对齐方式（如 :--- 或 :---:）会自动解析并写入 AsciiDoc 表格的 cols 属性定义中。