Markdown 转 AsciiDoc

把常见 Markdown 结构改写成 AsciiDoc 语法,适合迁移到 Antora、Asciidoctor 等文档流程。

Markdown 输入

86 字符

AsciiDoc 预览

转换后的文字
= 项目笔记

清晰的文档从*明确的结构*开始。

== 检查重点

* 层级清楚的标题
* 可以正常打开的链接
* 便于继续编辑的文件

> 下载前先检查渲染预览。
文件在当前浏览器标签页中处理。

如何把 Markdown 转成 AsciiDoc

转换后应在实际 AsciiDoc 构建工具中跑一次。

01

加入 Markdown

打开文档,优先处理标准标题、列表、链接、表格和代码块。

02

检查语法结果

确认标题层级、代码块语言和交叉引用没有歧义。

03

复制或下载源文件

放入目标文档项目,并用实际构建环境验证。

源代码迁移

保留文档语义,改用 AsciiDoc 写法

重点是转换结构,不会替你配置完整发布工程。

标题和列表转换常见层级、项目符号和编号列表。
代码与表格为常见代码块和简单表格生成相应语法。
可继续编辑输出仍是纯文本,便于在版本库中维护。
常见用途

团队改用 AsciiDoc 时

Antora 文档

迁移现有 README 和指南,作为 Antora 内容起点。

技术出版

为 Asciidoctor 的 HTML、PDF 或 EPUB 流程准备源文件。

项目规范统一

将零散 Markdown 转成团队约定的文档格式。

常见问题

Markdown 转 AsciiDoc 常见问题

转换后可以直接用 Asciidoctor 构建吗?

标准结构通常可以作为起点,但项目属性、主题、include 和扩展宏仍需按实际工程配置。

表格能完整转换吗?

简单行列表格较容易转换,复杂嵌套内容应在 AsciiDoc 渲染结果中检查。

会连接 Antora 或 Confluence 吗?

不会。页面只生成 AsciiDoc 文本,不登录或同步第三方平台。