Usage: asciidoctor [OPTION]... FILE... Convert the AsciiDoc input FILE(s) to the backend output format (e.g., HTML 5, DocBook 5, etc.) Unless specified otherwise, the output is written to a file whose name is derived from the input file. Application log messages are printed to STDERR. Example: asciidoctor input.adoc -b, --backend BACKEND set backend output format: [html5, xhtml5, docbook5, manpage] (default: html5) additional backends are supported via extended converters (e.g., pdf, epub3) -d, --doctype DOCTYPE document type to use when converting document: [article, book, manpage, inline] (default: article) -e, --embedded suppress enclosing document structure and output an embedded document (default: false) -o, --out-file FILE output file (default: based on path of input file); use - to output to STDOUT --safe set safe mode level to safe (default: unsafe) enables include directives, but prevents access to ancestor paths of source file provided for compatibility with the asciidoc command -S, --safe-mode SAFE_MODE set safe mode level explicitly: [unsafe, safe, server, secure] (default: unsafe) disables potentially dangerous macros in source files, such as include::[] -s, --no-header-footer suppress enclosing document structure and output an embedded document (default: false) -n, --section-numbers auto-number section titles in the HTML backend; disabled by default --eruby ERUBY specify eRuby implementation to use when rendering custom ERB templates: [erb, erubi, erubis] (default: erb) -a, --attribute name[=value] a document attribute to set in the form of name, name!, or name=value pair this attribute takes precedence over the same attribute defined in the source document unless either the name or value ends in @ (i.e., name@=value or name=value@) -T, --template-dir DIR a directory containing custom converter templates that override the built-in converter (requires tilt gem) may be specified more than once -E, --template-engine NAME template engine to use for the custom converter templates (loads gem on demand) -B, --base-dir DIR base directory containing the document and resources (default: directory of source file) -R, --source-dir DIR source root directory (used for calculating path in destination directory) -D, --destination-dir DIR destination output directory (default: directory of source file) -I, --load-path DIRECTORY add a directory to the $LOAD_PATH may be specified more than once -r, --require LIBRARY require the specified library before executing the processor (using require) may be specified more than once --failure-level LEVEL set minimum log level that yields a non-zero exit code: [INFO, WARN, ERROR, FATAL] (default: FATAL) -q, --quiet silence application log messages and script warnings (default: false) --trace include backtrace information when reporting errors (default: false) -v, --verbose directs application messages logged at DEBUG or INFO level to STDERR (default: false) -w, --warnings turn on script warnings (default: false) -t, --timings print timings report (default: false) -h, --help [TOPIC] print a help message show this usage if TOPIC is not specified or recognized show an overview of the AsciiDoc syntax if TOPIC is syntax dump the Asciidoctor man page (in troff/groff format) if TOPIC is manpage -V, --version display the version and runtime environment (or -v if no other flags or arguments)