第三篇 Asciidoc的正确打开方式 Vscode中使用Asciidoc

RockTec

已于 2024-10-06 20:42:35 修改

阅读量2.7k

点赞数 35

CC 4.0 BY-SA版权

分类专栏： Asciidoc 文章标签： vscode ide 编辑器

于 2024-05-06 22:16:33 首次发布

本文链接：https://blog.youkuaiyun.com/edl7878/article/details/138510018

Asciidoc 专栏收录该内容

15 篇文章 ¥19.90 ¥99.00

订阅专栏

本文介绍了Asciidoc的发展及其在Vscode中的使用方法，包括通过Asciidoctor进行文档转换，以及如何在Vscode中安装和使用Asciidoc插件实现边写边预览，同时探讨了Asciidoc作为纯文本格式在代码管理和多人协作中的优势。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在浏览器中 Asciidoc 文件，仅仅是编辑 Asciidoc 文件的若干方法之一。它的缺点是插入图片需要到别的地方找图床，这就很不方便。

我们都有自己熟悉的文本编辑器，或者集成开发环境（IDE）。在自己喜欢的 IDE 中，编辑 Asciidoc 文件，然后实时预览，岂不美哉？

Asciidoc 的发展史

最早，Asciidoc 是作为一种标记规范提出的，生态不丰富。直到 Dan Allen 用 Ruby 写了一个 Asciidoc 解析器，这个解析器叫做 Asciidoctor，它可以将一个 asciidoc 文档，转换成 HTML 或者 PDF 格式。

Asciidoctor is a fast, open source, Ruby-based text processor for parsing AsciiDoc® into a document model and converting it to output formats such as HTML 5, DocBook 5, manual pages, PDF, EPUB 3, and other formats.

逐渐地，围绕 Asciidoctor， Asciidoc 的生态逐渐丰富起来。

首先，当然是人们在自己的本地编辑器，写Asciidoc文档，然后用命令行，调用 Asciidoctor 将 Asciidoc 文档转化为 PDF 或者别的格式。在转化的过程中，Asciidoctor有个默认的格式模板，因此无论你输出 html 或者 pdf 都能得到一个一致的，并且排版足够优雅的文档。例如本篇文档的 html 输出结果：

了解本专栏