>

Convert AsciiDoc With Asciidoctor

Turn .adoc files into HTML with tables, admonitions and includes.

LinuxmarkdowndocumentationconvertLow risk
Run asciidoctor README.adoc to produce README.html.

01Command

Command
$ asciidoctor README.adoc

02What it does

Asciidoctor converts the rich AsciiDoc markup to HTML5, DocBook or PDF (with a backend), supporting includes, attributes and cross-references. It is popular for technical manuals that need more structure than Markdown.

03Risk

RiskLow risk
Requirementssudo apt install asciidoctor
!Warning: Some features such as PDF output need extra gems or a separate toolchain; check the backend you rely on.

04Undo

✓No undo needed — this command does not change persistent state.

05Sources

  • Debian package: asciidoctor
    Debian · vendor-doc · 2026-09-20
    Evidence: Debian packages Asciidoctor, a Ruby implementation of the AsciiDoc converter.
  • Asciidoctor
    Official project · vendor-doc · 2026-09-20
    Evidence: Debian packages Asciidoctor, a Ruby implementation of the AsciiDoc converter.

Last verified: 2026-09-22 · Category: Developer