AsciiDoc è un formato per documenti di testo, a marcatori, leggibile direttamente da sorgente e semanticamente equivalente a DocBook XML, che usa convenzioni di testo semplice come marcatori. Documenti AsciiDoc possono essere creati usando un qualunque editor di testo semplice e letti “come stanno”, o trasformati in HTML o qualsiasi altro formato supportato dal gruppo di programmi di elaborazione di DocBook, come PDF, TeX, pagine man Unix, e-book, presentazioni, ecc.^[1]

AsciiDoc è stato creato nel 2002 da Stuart Rackham, a cui si deve la pubblicazione degli strumenti "asciidoc" e "a2x", scritti in linguaggio di programmazione Python per convertire file di testo semplice, "umanamente leggibili", in formati standard per la pubblicazione di documenti.^[1]

Un'implementazione in Ruby chiamata "Asciidoctor", pubblicata nel 2013, viene usata da GitHub^[2] e fornisce anche un metodo per l'uso di Asciidoc in Java.

Alcuni dei libri e ebook di O'Reilly Media sono generati partendo da sorgenti AsciiDoc.^[3]

Buona parte della documentazione di Git è scritta in AsciiDoc.^[4]

Il seguente testo mostra l'uso di marcatori AsciiDoc e un risultato simile a quello prodotto da un elaboratore di AsciiDoc:

= Mio articolo
P. Rossi

http://wikipedia.org[Teknopedia] è 
un'enciclopedia on-line, disponibile in
inglese e molte altre lingue.

== Software

You can install 'package-name' using
the +gem+ command:

 gem install package-name

== Hardware

I metalli usati comunemente sono:
* rame
* stagno
* piombo

gem install package-name

Linguaggi a marcatori leggeri simili:

• Creole
• Markdown
• Org-mode
• Plain Old Documentation, utilizzato per la documentazione di Perl
• ReStructuredText, utilizzato per la documentazione di Python
• Setext
• Textile
• txt2tags
• Wikitesto

• Asciidoc “cheat-sheet” reference guide, su powerman.name.
• MPLW - Matplotlib charting filter for AsciiDoc, su volnitsky.com. URL consultato il 12 aprile 2015 (archiviato dall'url originale il 3 aprile 2015).
• RTextDoc. Editor with AsciiDoc support., su jwork.org.
• AsciidocToGo. Frontend to convert AsciiDoc txt files, su dbcb.github.io.

Portale Software libero: accedi alle voci di Teknopedia che trattano di software libero