This article needs additional citations for verification. (March 2014)
.adoc, .asciidoc, .txt
|Internet media type|
|Original author(s)||Stuart Rackham|
|Developer(s)||Matthew Peveler, Dan Allen, Michel Krämer, et al.|
|Initial release||November 25, 2002|
9.1.1 / September 18, 2021
|Original author(s)||Ryan Waldron|
|Developer(s)||Dan Allen, Sarah White, et al.|
|Initial release||January 30, 2013|
2.0.17 / January 6, 2022
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. Common file extensions for AsciiDoc files are
txt (as encouraged by AsciiDoc's creator) and
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.
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 encyclopaedia, 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
- 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 8.
- AsciiDocLIVE – AsciiDocLIVE is a free online AsciiDoc editor.
- "AsciiDoc". Archived from the original on 2016-03-03. Retrieved 2013-10-18.
- "AsciiDoc Frequently Asked Questions". asciidoc.org. Retrieved 2020-03-20.
- "AsciiDoc Recommended Practices | Asciidoctor". asciidoctor.org. Retrieved 2020-03-20.
- "AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories".
- "Asciidoc". GitLab User Docs. Archived from the original on 2019-07-22. Retrieved 6 Feb 2020.
- "AsciiDoc 101 (chapter 4 of Getting Started with Atlas)". Author Welcome Kit. O'Reilly Media. Archived from the original on 14 October 2017. Retrieved 19 May 2016.
- "Git wiki". Git SCM.
- "AsciiDoc Language".
- "AsciiDoc Working Group Charter".
- Official website
- Using AsciiDoc and Asciidoctor to write documentation - An AsciiDoc Tutorial