Elysia Tools

在一个清晰的工作台里浏览工具、案例、可视化和主题指南。

热门分类

专题

语言
ZHDERUPTENFRES

Elysia Tools

导航

Format Conversion

Markdown ⇄ AsciiDoc 转换器

· 最后更新:2026-08-22

在 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)语义不承诺无损,重点是单次迁移的正确性。

执行

运行这个工具

填写表单、运行工具,并在同一页面查看结果。

案例

与这个工具匹配的案例

相关内容

继续查看相关工具与专题

由 Elysia Tools 团队编写

工具使用指南

详细了解工具的适用范围、支持能力及用户案例。

关键事实

分类
Format Conversion
输入类型
select, textarea, checkbox
输出类型
html
案例覆盖
4
API 可用
是

概览

Markdown ⇄ AsciiDoc 转换器是一款双向文档语法转换工具,支持在 GitHub 风格 Markdown(GFM)与 AsciiDoc 之间互转。它能精确处理标题层级映射、链接语法翻转、代码围栏、管道表格、警示块(Admonitions)以及任务列表等核心排版元素,并对无法无损映射的高级指令提供清晰提示。

适用场景

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

使用方式

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

常见用途

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

示例

1. Markdown 发行说明转 AsciiDoc

技术文档工程师

背景

项目从 Markdown 静态站点迁移至基于 Antora 的 AsciiDoc 文档体系,需要转换现有的发布日志。

问题

包含一级标题、链接、任务列表、警告提示和 Python 代码块的 Markdown 文本需要手动调整大量语法符号。

如何使用

选择方向为“Markdown → AsciiDoc”,勾选“将首个 H1 提升为文档标题”,粘贴 Markdown 源码即可获取标准 AsciiDoc 格式。

方向: md2ad, 将首个 H1 提升为文档标题: true, 保留未映射标记并提示: true

结果

H1 成功提升为 = 文档标题,链接转为 URL[文本],代码块生成 [source,python] 容器,表格和警示块均符合 Asciidoctor 标准。

2. AsciiDoc 模块手册转 GitHub Markdown

开源维护者

背景

维护者需要将已有的 AsciiDoc 文档模块内容同步到 GitHub 代码仓库的根目录作为说明文件。

问题

GitHub 原生渲染 Markdown 体验更好,需要将 |=== 表格、NOTE: 块和 link: 宏还原为 GFM 格式。

如何使用

选择方向为“AsciiDoc → Markdown”,将 AsciiDoc 文本粘贴到输入区,复制转换后的 Markdown 输出。

方向: ad2md, 将首个 H1 提升为文档标题: false, 保留未映射标记并提示: true

结果

NOTE: 成功转为 GitHub 标准的 > [!NOTE] 提示框,|=== 表格还原为管道表格,代码块还原为三重反引号围栏。

常见问题

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 属性定义中。

首页
工具3212
案例593
可视化471
文件查看器103
专题239
标签333
图像、音频与视频657

图像、音频、视频处理、转换与优化工具

数学、日期与金融647

计算器、数值计算、日期逻辑、统计与金融工具

设计与颜色298

颜色、版式、图形、视觉样式与设计辅助工具

文本与写作209

写作、清洗、格式化、提取与文本分析工具

开发与 Web193

开发者工具、网络处理、Web 调试与自动化辅助工具

转换与编码175

格式、文件、压缩包、单位与编码转换工具

潜客测验发布与联系人交接
讣告、悼词与纪念卡的家属复核及交付
本地习惯记录的备份、恢复演练与分享前检查
长文改编 X 串文与 LinkedIn 帖子的事实复核与交付
Markdown 互动课件审校、离线演示与交付

© 2026 Elysia Tools. 保留所有权利。

文档价格关于我们服务条款隐私政策Cookie 政策联系我们
数据格式

Markdown 示例

Markdown 格式示例,从简单到复杂的文档结构

文档文件

Markdown 查看器样本

用于 README 预览、文档渲染和富文本标记测试的 Markdown 样本文件

文档

Markdown 幻灯片示例

用于测试 PDF 导出的 Remark/Marp 风格 Markdown 幻灯片

文档文件

PDF示例

2026-02-01 到 2026-02-10 工具生成的PDF示例

Format Conversion

Markdown转HTML转换器

将Markdown文本转换为HTML,支持自定义格式化选项

Format Conversion

Markdown转纯文本

将Markdown格式文本转换为纯文本,移除所有Markdown语法和格式

Design

Figma iOS Android pt dp sp 响应式设计规范卡

把 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 断点。

Cryptography

哈希算法对比器

对同一输入同时用 MD5、SHA-1、SHA-256、SHA-512、BLAKE2b、BLAKE3 哈希并横向对比:输出长度、十六进制/Base64 摘要、安全状态(已破解/现代)以及相对速度基准。适合教学、选择哈希算法或核对校验和。