RST 转 AsciiDoc转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
reStructuredText与AsciiDoc Document的定位并不相同：reStructuredText 是 Python 世界的标记语言——Sphinx 文档、PyPI README、docstring 工具链都用它。下划线式标题、指令与交叉引用，为可扩展的技术文档而生。当文档需要进入 Word、Markdown 管线或 HTML 站点且不能丢结构时，转换 AsciiDoc。
由于整个转换都在你的设备上完成，它快速、无限量且真正私密——无需账号、没有水印、文件不会出现在任何服务器上。多个文件一次性转换。
RST 与 AsciiDoc 的对比
| RST | AsciiDoc | |
|---|---|---|
| 数据结构 | 纯文本 + 指令 | 纯文本标记（==、[source]、|===） |
| 最适合 | 技术文档 | 技术书与大型文档集 |
如何将 RST 转换为 AsciiDoc
- 1
选择文件
选择你的 RST 文件。
- 2
立即转换
文件先转换成 Markdown（保留标题、列表与段落的中间格式），再重建为目标格式。
- 3
下载结果
下载 AsciiDoc——结构保留，复杂排版被简化。
关于 RST 格式
reStructuredText 是 Python 世界标准化的标记语言：Sphinx 用它构建整套文档站，PyPI 用它渲染项目介绍，docutils 等工具链围绕它建立。标题用标点下划线标出，.. image:: 和 .. code-block:: 之类的指令在不破坏纯文本可读性的前提下扩展能力。
RST 比 Markdown 更严格是有意为之——正是这种严格让大型文档树保持一致。把 RST 转成 Markdown 或 Word 能让 Sphinx 项目向全团队开放；把 Markdown 转回 RST 则能喂给 Sphinx 构建。
+优点
- ✓Sphinx/Python 文档的原生格式
- ✓大规模下依然一致：指令、角色、交叉引用
- ✓表格与提示框是一等语法
!局限
- −普及度不如 Markdown
- −更严格的规则有学习成本
- −部分指令绑定特定工具链
关于 AsciiDoc 格式
AsciiDoc 是轻量标记长大后的样子。Markdown 止步于粗体和列表，而 AsciiDoc 能承载扉页、多级章节、标注、警示、交叉引用和真正的表格语法——足以全程用纯文本写出整本技术书。Git 与 Linux 内核文档生态都以它为标准，通过 Asciidoctor 渲染。
这个格式的弱点是工具引力：Asciidoctor/Ruby 世界之外的 AsciiDoc 转换器很稀缺——这正是 Pandoc 补位的地方。转成 Word 可把书稿交到 Office 里的编辑手上；转成 Markdown 可接入现代文档站。章节结构与表格全程保留。
+优点
- ✓书籍级结构：章节、标注、警示、交叉引用
- ✓驱动 Git 与 Linux 内核文档——大规模实战检验
- ✓纯文本状态下依然可读
!局限
- −对随手笔记而言语法比 Markdown 重
- −转换器生态集中在 Asciidoctor 工具链
- −方言多（旧 asciidoc 与 asciidoctor）
为什么把 RST 转换成 AsciiDoc？
转换的意义在于 AsciiDoc 的长处正好补上 RST 给不了的东西：书籍级结构：章节、标注、警示、交叉引用而另一边，普及度不如 Markdown用上面的转换器过一遍，你的文件就站到了正确的取舍那边。
常见问题
RST 转 AsciiDoc 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
RST 转 AsciiDoc 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
转换出来的 AsciiDoc 之后还能编辑吗？
取决于目标格式：AsciiDoc 为自己的用途而生，本转换器忠实还原其内容，而不是凭空制造可编辑结构。需要大量再编辑时，请从面向编辑的格式入手，最后在这里导出终稿。
RST 文件的排版会完全保留吗？
本转换器会把 RST 的内容渲染成 AsciiDoc，在目标格式允许的范围内尽量保持页面、比例与图片原样。下载前请用预览确认效果符合预期。