# Markdown ⇄ AsciiDoc 转换器

在 GitHub 风格 Markdown 与 AsciiDoc（Antora / Red Hat / Asciidoctor 文档系统的标准格式）之间互转：标题层级自动偏移（AD 的 = 是文档级标题）、链接方括号顺序自动翻转、围栏代码块 ⇄ [source] 块、GFM 管道表 ⇄ |=== 表、NOTE/TIP/WARNING 警示块、任务列表、脚注、交叉引用锚点、硬换行等全部覆盖，无法完美映射的构造会列出提示。

> 标准页面: https://elysiatools.com/zh/tools/markdown-asciidoc-converter

- **分类:** Format Conversion

- **关键词:** markdown转asciidoc, asciidoc转markdown, antora迁移, asciidoctor转换, 文档格式转换

## 概述

转换器为无依赖的行级块解析器 + 行内标记词法分析，双向实现。核心规则：MD 的 #/## 映射到 AD 的 ==/===（除非把首个 H1 提升为 = 文档标题）；MD [文本](URL) 翻转为 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）语义不承诺无损，重点是单次迁移的正确性。

## 输入项

- **转换方向** (select)
- **源文档** (textarea): Paste your Markdown (or AsciiDoc when converting back)…
- **将首个 H1 提升为文档标题** (checkbox)
- **保留未映射标记并提示** (checkbox)

## 适用场景

- 将托管在 GitHub/GitLab 的 Markdown 文档迁移至 Antora 或 Asciidoctor 文档系统时
- 将企业级 AsciiDoc 规范手册转回 Markdown 以便在开源仓库或知识库中直接渲染时
- 需要跨格式重用带有复杂表格、代码块或提示框（NOTE/WARNING）的技术文档片段时

## 工作原理

- 选择转换方向（Markdown → AsciiDoc 或 AsciiDoc → Markdown）并配置标题提升与未映射标记保留选项。
- 将源文本粘贴到输入框中，行级块解析器与词法分析器即时解析结构和行内标记。
- 自动转换标题符号、链接格式、代码块语法、表格 colspec 及警示块风格，并在右侧直接展示转换结果。

## 使用案例

- 开源项目从 Markdown 知识库迁移到 Antora 多版本技术文档站点
- 将 AsciiDoc 格式的系统架构手册提取并转换为 README.md 发布在 GitHub
- 快速转换包含代码高亮、表格和警示标注的发行说明（Release Notes）

## 常见问题

### Markdown 与 AsciiDoc 的标题层级是如何映射的？

AsciiDoc 的单个等号（=）代表文档级标题，开启提升首个 H1 选项后 Markdown 的 # 转为 =，## 转为 ==；关闭时 # 默认对应 ==。

### 链接语法在转换时会发生什么改变？

Markdown 的 [文本](URL) 会翻转为 AsciiDoc 的 URL[文本]；若 URL 包含括号或下划线，会自动用 ++...++ 透传包裹以避免格式冲突。

### GitHub 警示块（Alerts）能否转换？

支持，Markdown 中的 > [!NOTE] 或 > **Note** 会被转换为 AsciiDoc 的 NOTE: 块，反向转换同样支持。

### AsciiDoc 特有的 include 指令和属性变量如何处理？

在转为 Markdown 时，include:: 指令、属性引用和条件编译会降级为 HTML 注释保留，并附带转换提示。

### 工具是否支持复杂的 GFM 表格对齐？

支持，GFM 表格的分隔行对齐方式（如 :--- 或 :---:）会自动解析并写入 AsciiDoc 表格的 cols 属性定义中。

## 相关工具

- [Markdown转HTML转换器](https://elysiatools.com/zh/tools/markdown-to-html): 将Markdown文本转换为HTML，支持自定义格式化选项
- [Markdown转纯文本](https://elysiatools.com/zh/tools/markdown-to-plain-text): 将Markdown格式文本转换为纯文本，移除所有Markdown语法和格式
- [Figma iOS Android pt dp sp 响应式设计规范卡](https://elysiatools.com/zh/tools/figma-ios-android-pt-dp-sp-responsive-design-spec-card): 把 Figma 像素值换算成平台正确单位并生成开发者规范卡：iOS pt（@1x/@2x/@3x 及各倍率渲染 px）、Android dp/sp（mdpi…xxxhdpi 全密度桶渲染表、字体缩放）、Web rem/vw 与 clamp() 流式排版片段；按 iOS 44pt / Android 48dp / WCAG 44px 与 24px 审计最小触控目标，并标注 Material 窗口类与 Tailwind 断点。
- [哈希算法对比器](https://elysiatools.com/zh/tools/hash-algorithm-comparator): 对同一输入同时用 MD5、SHA-1、SHA-256、SHA-512、BLAKE2b、BLAKE3 哈希并横向对比：输出长度、十六进制/Base64 摘要、安全状态（已破解/现代）以及相对速度基准。适合教学、选择哈希算法或核对校验和。
- [OKR 与 KPI 树状分解器](https://elysiatools.com/zh/tools/okr-tree-decomposer): 把公司级 Objective 逐级下钻到部门→团队→个人,每个节点设权重/目标值/当前值,下层加权汇总为上层完成度。输出可视化树状结构 + Markdown,可复制到文档。
- [AI图片转Markdown](https://elysiatools.com/zh/tools/ai-image-to-markdown): 使用AI视觉模型从图片中提取文本并转换为Markdown格式
- [血清阴离子间隙 (AG) 计算器](https://elysiatools.com/zh/tools/anion-gap-calculator): 计算血清阴离子间隙 AG = Na⁺ − Cl⁻ − HCO₃⁻ (mmol/L)，并可选用 Na⁺ + K⁺ 公式与白蛋白校正。AG 升高（约 >12）提示未测阴离子蓄积（乳酸、酮体、甲醇/乙二醇、水杨酸、肾衰竭；口诀 GOLD-MARK）。AG 正常（8–12）的代谢性酸中毒为高氯性，考虑腹泻、肾小管酸中毒、大量生理盐水输注。AG 偏低（<3–6）多见低白蛋白血症，也见于高钙/高镁、锂、IgG 骨髓瘤（阳离子型副蛋白）、溴化物假性高氯。低白蛋白时用白蛋白校正公式 AG_corr = AG + 2.5×(4.0 − 白蛋白) 避免漏诊高 AG 酸中毒。来源 Kraut CJASN 2007、Figge 1998、MDCalc。需结合血气与临床。不构成医疗建议。
- [缩进列表转 ASCII 目录树](https://elysiatools.com/zh/tools/ascii-tree-from-indented-list): 把 2 空格 / 4 空格 / Tab 缩进的层级列表（Markdown bullet、- * 1. 前缀可选）渲染为可复制的 ASCII 目录树。支持 Unicode 方框与经典 ASCII 两种风格，以及整根纵线、行尾空格、叶节点方括号等开关。

## 示例

- [Markdown 示例](https://elysiatools.com/zh/samples/markdown-samples): Markdown 格式示例，从简单到复杂的文档结构
- [Markdown 查看器样本](https://elysiatools.com/zh/samples/markdown-viewer-samples): 用于 README 预览、文档渲染和富文本标记测试的 Markdown 样本文件
- [Markdown 幻灯片示例](https://elysiatools.com/zh/samples/md-slide-deck-to-pdf): 用于测试 PDF 导出的 Remark/Marp 风格 Markdown 幻灯片
- [PDF示例](https://elysiatools.com/zh/samples/pdf-samples): 2026-02-01 到 2026-02-10 工具生成的PDF示例