Free online ADOC to PDF converter

A recipient, printer, archive system, or document workflow may require a fixed-layout PDF instead of editable AsciiDoc source. Rendering the source as PDF preserves pagination and makes the document viewable without an AsciiDoc tool.

What the ADOC format is

ADOC is the common filename extension for an AsciiDoc document; .asciidoc and .asc are also used. It is a plain-text source format containing markup for headings, lists, links, tables, attributes, image references, and include:: directives.

Developers, technical writers, and documentation teams use ADOC files with tools such as Asciidoctor, AsciidoctorJ, and Antora. A text editor displays source markup such as = Document title and == Section, not the paginated document produced by rendering.

What the PDF format is

PDF is a page-description format that retains page size, typography, spacing, images, and pagination across operating systems and printers. It is suitable for printing, sharing, archival copies, and documents that must be viewed consistently on different devices.

PDF is less convenient to edit than ADOC. For source-controlled documentation, edit the ADOC file and regenerate the PDF rather than modifying the PDF directly.

How to convert an ADOC file to PDF

Using Asciidoctor PDF

Asciidoctor PDF is the most direct local converter because it interprets AsciiDoc syntax and creates PDF without an intermediate HTML file. It requires Ruby.

1. Install Ruby if it is not already available on the computer.
2. Install Asciidoctor PDF from a terminal with gem install asciidoctor-pdf.
3. Open the terminal in the directory containing the source file, or provide its full path.
4. Run asciidoctor-pdf document.adoc -o document.pdf.
5. Open the result and check headings, links, images, tables, code blocks, and page breaks.

Replace the filenames with the actual source and output names. A custom PDF theme can be supplied with an attribute such as -a pdf-theme=my-theme.yml, provided the theme file and any referenced fonts are available.

Asciidoctor PDF can also be integrated into scripts and documentation builds, which is preferable when PDFs must be regenerated consistently from version-controlled source.

Using 101convert.com

You can convert the file for free on 101convert.com without installing software: upload the .adoc file, choose PDF as the output format, start the conversion, and download the result. Use local Asciidoctor PDF for confidential documents or files that depend on local images, includes, custom themes, or extensions.

Quality and compatibility considerations

• Renaming document.adoc to document.pdf does not convert the file; the AsciiDoc source must be rendered.
• Relative image paths and include:: directives must resolve correctly. Missing files can create blank image areas or unresolved include content.
• Asciidoctor PDF uses its own themes and layout rules. CSS used for HTML AsciiDoc output does not determine the PDF appearance.
• Fonts must be installed or supplied to the PDF build and must contain the required characters. Otherwise, glyphs can be substituted or shown as missing-character boxes.
• Diagrams, charts, syntax highlighting, and generated code samples may require additional AsciiDoc extensions, executables, or build steps before PDF generation.
• Long tables and code blocks can break awkwardly at page boundaries. Adjust widths, theme settings, or page-break controls and inspect the rendered PDF before distribution.
• PDF output depends on the converter version, theme, fonts, and included assets, so different environments can produce slightly different pagination.