AsciiDoc
Human-readable document format From Wikipedia, the free encyclopedia
AsciiDoc is a human-readable document format, semantically equivalent to DocBook XML, but using plain-text mark-up conventions. AsciiDoc documents can be created using any text editor and read “as-is”, or rendered to HTML or any other format supported by a DocBook tool-chain, i.e. PDF, TeX, Unix manpages, e-books, slide presentations, etc.[2] Common file extensions for AsciiDoc files are adoc[3] and historically txt (as encouraged by AsciiDoc's creator).[4]
 | This article needs additional citations for verification. (March 2014) |
| Filename extensions |
.adoc, .asciidoc, .txt |
|---|---|
| Internet media type |
text/asciidoc, text/plain |
| Initial release | November 25, 2002 |
| Open format? | Yes |
| Website | asciidoc |
| Original author(s) | Ryan Waldron |
|---|---|
| Developer(s) | Dan Allen, Sarah White, et al. |
| Initial release | January 30, 2013 |
| Stable release | |
| Repository | github |
| Written in | Ruby |
| Operating system | Cross-platform |
| Type | Documentation generator |
| License | MIT |
| Website | asciidoctor |
The AsciiDoc format is undergoing standardization by the Eclipse Foundation.[5][6]
History
Summarize
Perspective
Early history
| Original author(s) | Stuart Rackham |
|---|---|
| Developer(s) | Matthew Peveler, Dan Allen, Michel Krämer, et al. |
| Initial release | November 25, 2002 |
| Stable release | |
| Repository | github |
| Written in | Python |
| Operating system | Cross-platform |
| Type | Documentation generator |
| License | GPL v2 |
| Website | asciidoc-py |
AsciiDoc was created in 2002 by Stuart Rackham, who published tools (‘asciidoc’ and ‘a2x’), written in the Python programming language to convert plain-text, ‘human readable’ files to commonly used published document formats.[2]
A Ruby implementation called ‘Asciidoctor’, released in 2013. An implementation is also available in the Java ecosystem using JRuby and in the JavaScript ecosystem using Opal.js. Further implementations exist in Haskell and Go.
Standardization and primacy of Asciidoctor (2019 – present)
Since the beginning of the standardization process in 2019, the Asciidoctor project has aimed to produce an independent, compatible implementation
of the AsciiDoc specification in the making, with the support of Stuart Rackham, the original author of the language.[8] The official website of the AsciiDoc language has since begun linking to Asciidoctor's documentation of the language.
The beginning of the standardization process in 2019 coincided with the release of Asciidoctor 2.0 and several parts of syntax being deprecated, such as single quotation marks (') to indicate italics.[9] Legacy syntax remains available through a compatibility mode.[10]
The original Python implementation by Stuart Rackham continues to be developed under the moniker of AsciiDoc.py. Since 2021, it is described as legacy
in own documentation and formally targets the older rendition of the language.[11]
Notable applications
![[icon]](#/media/File:Wiki_letter_w_cropped.svg){kind=small} | This section needs expansion. You can help by adding to it. (March 2025) |
Most of the Git project documentation is written in AsciiDoc.[12]
Some of O'Reilly Media's books and e-books are authored using AsciiDoc mark-up.[13]
Red Hat's product documentation is written in AsciiDoc.
Example
The following shows text using AsciiDoc mark-up, and a rendering similar to that produced by an AsciiDoc processor:
| AsciiDoc source text |
|---|
= My Article J. Smith https://wikipedia.org[Wikipedia] is an on-line encyclopedia, available in English and *many* other languages. == Software You can install _package-name_ using the `gem` command: gem install package-name == Hardware Metals commonly used include: * copper * tin * lead |
| HTML-rendered result |
|---|
|
J. Smith Wikipedia is an on-line encyclopedia, available in English and many other languages. You can install package-name using the gem command: gem install package-name Metals commonly used include:
|
Tools
- Antora – a multi-repository documentation site generator for tech writers using git.
- AsciiBinder – (deprecated) a documentation system built on Asciidoctor for people who have a lot of docs to maintain and republish on a regular basis.
- awestruct – a static site generator inspired by Jekyll.
- Asciidoc FX – AsciiDoc Book Editor based on JavaFX 18.
- AsciiDocLIVE – AsciiDocLIVE is a free online AsciiDoc editor.
- DAPS – DocBook Authoring and Publishing Suite (DAPS) is command-line software to publish DocBook & AsciiDoc as HTML, PDF, and EPUB.
See also
References
External links
Wikiwand - on
Seamless Wikipedia browsing. On steroids.