在线将 ADOC 转换为 PDF

ADOC 转 PDF 转换器——常见问题解答 ▼

在线将 ADOC 转换为 PDF — AsciiDoc 转可移植文档

AsciiDoc 是技术文档的首选标记语言——软件手册、API 参考、架构决策记录和开发者手册。用 .adoc 编写可获得版本受控的纯文本；向工程团队以外的利益相关者分享则需要他们无需 AsciiDoc 处理器即可打开的格式。将 ADOC 转换为 PDF 可生成干净的格式化文档，其中标题、列表、代码块、表格和标注框的渲染效果与预期完全一致——可在任何设备上阅读、可打印、可签署，且无需收件人安装 Asciidoctor、Ruby 或任何构建工具链。

什么是 ADOC 文件？

ADOC 文件是 AsciiDoc 纯文本文档。AsciiDoc 是一种轻量级标记语言，语义比 Markdown 更丰富——它原生支持交叉引用、包含、条件指令和复杂表格结构。该格式广泛用于软件文档工作流，尤其是使用 Antora、Asciidoctor 或 DocBook 作为发布管道的项目。

• 扩展名：.adoc（旧文件也使用 .asciidoc 或 .asc）
• 编码：UTF-8 纯文本——可用 Git 进行版本控制，便于差异比较
• 处理器：Asciidoctor（Ruby）、AsciidoctorJ（JVM）、asciidoctor-pdf 用于原生 PDF 输出
• 使用者：Red Hat、Spring Framework、Quarkus、Couchbase 以及许多开源项目用于官方文档
• 比 Markdown 更丰富：原生支持表格、脚注、参考文献、跨文件包含和条件内容块

谁需要 ADOC 转 PDF？

• 分享草稿的技术写作人员：将进行中的文档发送给没有安装 Asciidoctor 的产品经理、法律审阅者或业务利益相关者。
• 提交文档的开发人员：大学课程、会议提交和客户交付物通常需要 PDF。ADOC 源文件几秒钟内即可转换。
• 开源项目维护者：为 README、CONTRIBUTING 或架构文档生成 PDF 版本，与发布档案一起分发。
• 没有构建管道的技术团队：并非每个团队都设置了 Asciidoctor 或 Antora 管道。在线转换器无需任何工具链配置即可处理文件。
• 合规和审计文档：用 AsciiDoc 编写的安全策略、运行手册和架构决策记录需要以 PDF 格式提交用于合规审查和审计。
• 内容团队交接：将最终确定的规范或设计文档从工程团队交给内容团队或外部机构，以通用可访问的格式进行审查。

ADOC 与 PDF — 主要区别

在线转换器 vs Total Doc Converter

下载 Total Doc Converter

通过命令行批量将 ADOC 转换为 PDF

Total Doc Converter 可从命令行将整个 AsciiDoc 文件夹转换为 PDF——非常适合文档发布管道或一次性转换一个仓库中的 .adoc 规范：

docconverter.exe /S "C:\Docs\*.adoc" /F PDF /O "C:\PDF-Output"

集成到构建脚本中，在生成 HTML 输出的同时自动生成文档的 PDF 版本。作为预发布步骤运行，从一个 AsciiDoc 源文件夹生成可分发的 PDF 手册，无需在每台构建机器上设置完整的 Asciidoctor 工具链。

ADOC File

PDF File