AsciiDoc Document

AsciiDoc is a file format and markup language used to create software documentation, webpage content, ebooks, articles, and other text documents. When an author writes a document that contains AsciiDoc syntax, they typically save the document as an ADOC file.

ADOC files are plain text files that can be opened, read, and edited in any text editor. After an author finishes editing the plain text version of an ADOC file, they typically use Asciidoctor or another text-processing program to convert their ADOC file into a formatted text file. For example, a technical writer may use Asciidoctor to convert an ADOC file into an HTML file, which can be hosted and shared on the Internet as a software manual.

You can open an ADOC file and edit the text it contains in any text editor, including Microsoft Notepad (Windows), Apple TextEdit (Mac), Microsoft Visual Studio Code (cross-platform), and GitHub Atom (cross-platform).

Asciidoctor can convert ADOC files to other file types, including the following formats:

To convert ADOC files with Asciidoctor, you must install software and the appropriate add-ons and call the processor in your terminal. For complete instructions on how to use Asciidoctor, review Asciidoctor's official documentation.

Programs that open or reference ADOC files

Updated: May 18, 2022