# Asciidoctor

:gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.

Repository: https://github.com/asciidoctor/asciidoctor
Canonical: https://ross.abutalabs.com/products/asciidoctor
Homepage: https://asciidoctor.org
Language: Ruby
License: NOASSERTION
License Family: other
Topics: asciidoctor, asciidoc, converter, ruby, html, docbook, manpage, rubygem
Last push: 2026-07-26T17:24:29+00:00
Link (homepage): https://asciidoctor.org
Link (site_page): https://asciidoctor.org/docs
Link (site_page): https://asciidoctor.org/docs/asciidoc-writers-guide
Link (site_page): https://docs.asciidoctor.org
Link (site_page): https://docs.asciidoctor.org/asciidoctor/latest

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 53, longevity 100
- inputs: {"age_days": 5206, "days_push": 38, "days_rel": 314, "gap_med": 5.0, "n_releases_24m": 3}
- flags: no_license, no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5208, forks 839 (observed 2026-08-28T04:09:13.003487+00:00)

## What it is
Asciidoctor is a fast, open source Ruby-based text processor and publishing toolchain that parses AsciiDoc content into a document model and converts it to HTML 5, DocBook 5, man pages, and, via add-on converters, PDF and EPUB 3. It offers both a CLI and an API, with ecosystem runtimes like AsciidoctorJ (JVM) and Asciidoctor.js (JavaScript) and extensions for diagrams, reveal.js, and build tool integrations.

## Use cases
- convert asciidoc to html
- generate pdf documentation from asciidoc
- write technical documentation in plain text
- convert asciidoc to docbook
- publish man pages from asciidoc source
- render asciidoc in a static site generator
- process asciidoc from java or javascript

## When to choose
- you want a mature, fast AsciiDoc processor with multi-format output (HTML, DocBook, PDF, EPUB)
- you need a CLI and API plus JVM/JavaScript runtimes for the same markup
- you're authoring long-form technical docs, books, or man pages in plain text

## When to avoid
- your team only writes simple Markdown and doesn't need AsciiDoc's advanced features
- you need WYSIWYG editing rather than a text-based markup pipeline
- you require a non-Ruby/JVM/JS runtime without an available integration

## Facets
- artifact type: library
- maturity: stable
- function: parser, templating, documentation, cli, pdf
- domain: documentation, developer-tools, web-development, pdf
- platform: ruby, jvm, cli, cross-platform
- tags: asciidoc, text-processor, publishing-toolchain, docbook, html5, manpage, epub, rubygem, technical-writing, nodejs

## Member repositories
- asciidoctor/asciidoctor (main) score 81
- asciidoctor/asciidoctor-pdf (plugin) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:13.003487+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:00:12.598831+00:00, confidence not recorded.
  - homepage: https://asciidoctor.org (fetched 2026-08-29T08:55:27.208024+00:00, sha 632c8e28cbf1)
  - site_page: https://asciidoctor.org/docs (fetched 2026-08-29T08:55:27.217768+00:00, sha fbb93c88964f)
  - site_page: https://asciidoctor.org/docs/asciidoc-writers-guide (fetched 2026-08-29T08:55:27.219878+00:00, sha d480750bd110)
  - site_page: https://docs.asciidoctor.org (fetched 2026-08-29T08:55:27.223267+00:00, sha d15b90f685a0)
  - site_page: https://docs.asciidoctor.org/asciidoctor/latest (fetched 2026-08-29T08:55:27.225063+00:00, sha e8f9880f37a5)
  - site_page: https://docs.asciidoctor.org/asciidoc/latest (fetched 2026-08-29T08:55:27.226849+00:00, sha 19bcb019294c)
- Data as of 2026-08-30T08:39:29.467469+00:00.