AsciiDoc 是什么，和 Markdown 有何区别?

AsciiDoc 是一种比 Markdown 更丰富的纯文本标记，由 Asciidoctor、Antora 文档站和不少技术书流水线读取(O'Reilly 就用它出版)。它长得很像 Markdown，但标题用前导等号，代码用 [source,lang] 属性加 ---- 围栏，链接写成 url[text]。Markdown 更简单、在 GitHub 上无处不在;AsciiDoc 多了告示框、include、属性和交叉引用，长文档和书需要这些。这个工具覆盖常用子集，让 Markdown 草稿落成合法的 AsciiDoc。

为什么 AsciiDoc 标题用等号而不是井号?

AsciiDoc 用前导等号的「数量」标记标题级别，正好和 Markdown 井号镜像。Markdown 的 # H1 变成单个等号(文档标题级)，## 变成 ==，### 变成 ===，一直到 ====== 对应 h6。所以 `## Install` 转成 `== Install`。等号数量必须对上目标级别，否则 Asciidoctor 会把章节嵌套错位，这个差一位的坑工具替你处理掉了。

围栏代码块怎么转成 source 块?

Markdown 的 ```python 这种围栏会变成两行的 AsciiDoc 结构:属性行 `[source,python]`，下面跟一个 `----` 围起来的 listing 块装代码，再用一个 `----` 收尾。没写语言的围栏会去掉属性行，直接输出裸的 `----` listing。围栏之间的内容原样照抄，所以样例里的 `#` 注释或 `*` 通配符绝不会被当成标题或粗体。

为什么我的链接现在长成 url[text] 了?

AsciiDoc 把网址放前面、标签放后面的方括号里，和 Markdown 正好反过来。所以 `[Toolora](https://toolora.com)` 变成 `https://toolora.com[Toolora]`。没有标签的链接，比如 `[](https://x.com)`，会拿网址当标签。图片同理，加 image: 前缀:行内 `![alt](u)` 变成 `image:u[alt]`，单独成行的图片变成块宏 `image::u[alt]`。

转换是在服务器上做的吗?

不是。整个转换是浏览器标签页里运行的纯 JavaScript，没有 markdown 库，也不发网络请求。你的文本不离开页面，内部文档、未发布的更新日志和私密笔记都可以放心粘。唯一会传出去的是分享链接，它把输入编进查询字符串，所以涉密内容别用分享链接，改用复制按钮。

粗体、斜体和行内代码混在一起能正确处理吗?

能。粗体 `**x**` 变 `*x*`，斜体 `*x*` 或 `_x_` 变 `_x_`，行内 `` `代码` `` 保留反引号，因为 AsciiDoc 等宽也用反引号。最棘手的是行内代码里有 `*` 或 `_`，比如 `` `a*b` `` :工具在处理强调之前先把代码抽出，最后再放回，所以代码里的星号绝不会被读成粗体。组合的 `***x***` 会映射成 `*_x_*`。

把 GitHub README 搬进 Antora 文档站

你的项目 README 是 Markdown，但文档门户用 Antora 搭，读的是 AsciiDoc。把 README 粘到左边，复制 AsciiDoc，标题变成等号章节，围栏安装片段变成 [source,bash] 块，链接翻成 url[text]。页面在门户里原生渲染，而不是显示一堆裸井号，看文档的非工程师就能看到排好版的内容。

把 LLM 回答转成 Asciidoctor 书的章节

Claude 或 ChatGPT 给你一段干净的 Markdown 讲解，带标题、步骤和代码样例，正好用在你写的 AsciiDoc 章节里。过一遍工具，source 块、有序步骤和强调全部落成 Asciidoctor 要的标记，直接粘进 .adoc 文件，不用手动重打每个标题和围栏。

把笔记从 Markdown 编辑器迁进 .adoc 文件

你在 Markdown 编辑器里写了一份运维手册，后来发现团队的运维文档是用 AsciiDoc 放在版本控制里。与其一个个手动重写标题、链接和代码块，把草稿过一遍转换器，复制 AsciiDoc，整份手册第一次保存就能作为合法的 .adoc 提交。

统一一个仓库里混杂的 Markdown 和 AsciiDoc

一个仓库里积累了 .md 和 .adoc 两种文件，而构建只渲染 AsciiDoc。把每个 Markdown 文件过一遍工具，把输出放进对应的 .adoc，文档构建就会带着 source 块和 image:: 宏一起把转好的页面收进来，不会再有半渲染的 Markdown 溜过工具链。

Markdown 转 AsciiDoc 转换器

把 GitHub Markdown 转成干净的 AsciiDoc，标题、source 代码块、url[text] 链接和 image:: 宏，全在浏览器里完成

本地处理
分类格式转换
适合把粘贴内容或本地文件转成更适合交付的格式。

Asciidoctor、Antora 和不少书籍工具链读的是 AsciiDoc，不是 Markdown。左边粘 Markdown，标题、**粗体**、*斜体*、`代码`、围栏块、链接、图片、列表和引用，右边出 AsciiDoc，直接放进 .adoc 文件。全部在这个标签页里跑。

Markdown

AsciiDoc182 字符

= 快速开始

安装 *toolora*，看一眼 https://toolora.com/docs[文档]。

* 快
* _纯前端_
* `pip install toolora`

____
为写 Asciidoctor 文档的人准备。
____

[source,python]
----
from toolora import run
run()
----

这个工具能做什么

免费的 Markdown 转 AsciiDoc 工具，给读 .adoc 而不是 .md 的 Asciidoctor、 Antora 和书籍工具链用。左边粘 GitHub 风格的 Markdown，右边边打字边出 AsciiDoc。标题从井号换成按级数排的前导等号(单个等号是 AsciiDoc 的 H1)，粗体降为单个星号，斜体变成下划线，围栏代码块转成 [source,lang] 属性加 ---- 包起来的 listing 块，链接从 [text](url) 改写成 AsciiDoc 要的 url[text] 形式，图片变成 image:: 块宏，有序列表收成一个点号标记，引用裹进 ____ 块。行内代码保留反引号，代码块里的内容一字不动，所以样例里的井号或星号绝不会被错当成标题或粗体。全部在这个标签页里运行，一键复制，分享链接可还原你的原始输入。100% 浏览器本地，不上传，不需要账号。

工具细节

输入: 文本 + 数值 + 结构化内容; 页面会根据工具类型展示文本框、数值控件、文件选择或结构化输入。
输出: 即时结果 + 复制; 结果区优先给出可操作结果，支持项会显示复制、下载或可视化预览。
隐私: 浏览器本地处理; 主工具逻辑未发现外部 API 调用，输入通常留在当前标签页内处理。
保存 / 分享: 可分享链接状态; 关键设置会进入 URL，复制链接后别人能复现同一组参数。
性能预算: 首屏 JS ≤ 9 KB; 没有声明 WASM 依赖，适合快速打开和移动端使用。
适用场景: 格式转换 · 程序员; 分类和职业标签用于推荐相关工具、组织内链，并帮助用户快速判断是否适合当前任务。

怎么用

1. 输入

把内容粘贴或拖入工具面板。
2. 处理

点击按钮,在浏览器内本地处理,文件不上传。
3. 复制 / 下载

一键复制结果或下载到本地。