你已经来到了旧版Asciidoctor文档的着陆页面。新版文档的着陆页面位于 https://docs.asciidoctor.org，现在是一个专门的网站。在新网站上，你可以找到最新的AsciiDoc标记语言、Asciidoctor处理器和工具链，以及众多Asciidoctor集成的文档。

如果你正在寻求来自社区成员的实时支持，请在https://asciidoctor.zulipchat.com[社区聊天]中的#users流下提出你的问题。你也可以在https://discuss.asciidoctor.org[讨论列表]中找到有用的信息，尽管请记住讨论列表作为沟通手段已经被淘汰，赞成使用社区聊天。

基础知识

发现Asciidoctor以及它如何能帮助你。

开始使用Asciidoctor

现在，让我们安装并使用Asciidoctor工具链！

使用AsciiDoc编写

AsciiDoc 语言文档

AsciiDoc语言的文档，如在Asciidoctor中实现的那样。

AsciiDoc 语法快速参考

你可能需要用到的AsciiDoc语法结构和格式化文档的概述。

AsciiDoc Writer’s Guide

一个全面的教程，其中包含了示例，用以展示如何使用 AsciiDoc 语法。

链接：asciidoc-recommended-practices/[AsciiDoc 风格指南与推荐实践]（草案）

撰写易于阅读和转换文档的风格提示和推荐实践。

AsciiDoc Article Template

一个包含了AsciiDoc文章文档中最常见的内容结构和标记的模板。

语法扩展

Asciidoctor Diagram

学习如何使用PlantUML、Graphviz、ditaa和Shaape在你的AsciiDoc文档中创建图表和ASCII艺术。

处理器

Asciidoctor Documentation

Asciidoctor是一个快速的开源Ruby-based文本处理器，用于将AsciiDoc解析成文档模型，并将其转换为HTML 5、DocBook 5、手册页、PDF和EPUB 3等输出格式。这个Ruby库通常被称为Asciidoctor核心。

安装和使用 AsciidoctorJ

AsciidoctorJ 将所有执行Asciidoctor所需的gem打包，并将其封装进Java API中，以便像其他任何Java库一样在Java中使用Asciidoctor。

安装并使用 Asciidoctor.js

Asciidoctor.js 将 AsciiDoc 带入了 JavaScript 的世界！

扩展转换器

Convert AsciiDoc to PDF with Asciidoctor

Asciidoctor PDF 是一个用于 AsciiDoc 的原生PDF转换器。我们谈论的是直接从 AsciiDoc 转换到 PDF！了解如何安装 Asciidoctor PDF 并使用它将你的 AsciiDoc 文档转换成 PDF。

使用Asciidoctor将AsciiDoc转换为EPUB3

Asciidoctor EPUB3是AsciiDoc的原生EPUB3转换器。了解如何安装Asciidoctor EPUB3以及如何使用它将你的AsciiDoc文档直接转换为EPUB3和亚马逊的KF8/Mobi格式，适用于Kindle。

Create a reveal.js presentation with Asciidoctor

Asciidoctor reveal.js 是 Asciidoctor 和 Asciidoctor.js 的一个转换器，它可以将 AsciiDoc 文档转换成 HTML5 演示文稿，这种文稿旨在由 reveal.js 演示框架执行。

构建自动化插件

迁移到Asciidoctor

  • 从AsciiDoc.py迁移到Asciidoctor

  • 从Docbook XML迁移到Asciidoctor

  • 从 Confluence XHTML 到 Asciidoctor 的迁移

  • 从MS Word迁移到Asciidoctor

为Asciidoctor做贡献

参考资料和开发者资源