This article needs additional citations for verification. Please help improve this article by adding citations to reliable sources. Unsourced material may be challenged and removed.Find sources: "AsciiDoc" – news · newspapers · books · scholar · JSTOR (March 2014) (Learn how and when to remove this template message)
AsciiDoc file format
Filename extensions
.adoc, .asciidoc, .txt
Internet media type
text/asciidoc, text/plain
Initial release2002; 22 years ago (2002)
Open format?yes
Websiteasciidoc.org Edit this at Wikidata
AsciiDoc.py
Original author(s)Stuart Rackham
Developer(s)Matthew Peveler, Dan Allen, Michel Krämer, et al.
Initial releaseNovember 25, 2002; 21 years ago (2002-11-25)
Stable release
10.2.0 / May 22, 2022; 20 months ago (2022-05-22)
Repositorygithub.com/asciidoc/asciidoc-py3
Written inPython
Operating systemCross-platform
TypeDocumentation generator
LicenseGPL v2
Websiteasciidoc-py.github.io
Asciidoctor
Original author(s)Ryan Waldron
Developer(s)Dan Allen, Sarah White, et al.
Initial releaseJanuary 30, 2013; 10 years ago (2013-01-30)
Stable release
2.0.18 / October 15, 2022; 15 months ago (2022-10-15)
Repositorygithub.com/asciidoctor/asciidoctor
Written inRuby
Operating systemCross-platform
TypeDocumentation generator
LicenseMIT
Websiteasciidoctor.org

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.[1] Common file extensions for AsciiDoc files are txt (as encouraged by AsciiDoc's creator) and adoc.[2][3]

History

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.[1]

Asciidoctor

A Ruby implementation called ‘Asciidoctor’, released in 2013, is in use by GitHub[4] and GitLab.[5] This implementation is also available in the Java ecosystem using JRuby and in the JavaScript ecosystem using Opal.js.

Some of O'Reilly Media's books and e-books are authored using AsciiDoc mark-up.[6]

Most of the Git project documentation is written in AsciiDoc.[7]

The AsciiDoc format is currently under standardization procedure by the Eclipse Foundation.[8][9]

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
My Article

J. Smith

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

Tools

See also

References

  1. ^ a b "AsciiDoc". Archived from the original on 2016-03-03. Retrieved 2013-10-18.
  2. ^ "AsciiDoc Frequently Asked Questions". asciidoc.org. Retrieved 2020-03-20.
  3. ^ "AsciiDoc Recommended Practices | Asciidoctor". asciidoctor.org. Retrieved 2020-03-20.
  4. ^ "AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories".
  5. ^ "Asciidoc". GitLab User Docs. Archived from the original on 2019-07-22. Retrieved 6 Feb 2020.
  6. ^ "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.
  7. ^ "Git wiki". Git SCM.
  8. ^ "AsciiDoc Language". 27 July 2020.
  9. ^ "AsciiDoc Working Group Charter".

External links


Document markup languages
Categories