10 releases (5 breaking)

0.6.0 Jun 7, 2024
0.5.1 May 31, 2024
0.4.0 Apr 24, 2024
0.3.4 Apr 23, 2024
0.1.0 Mar 28, 2024

#515 in Parser implementations

Download history 143/week @ 2024-03-25 220/week @ 2024-04-01 169/week @ 2024-04-08 150/week @ 2024-04-15 274/week @ 2024-04-22 7/week @ 2024-04-29 135/week @ 2024-05-13 28/week @ 2024-05-20 191/week @ 2024-05-27 170/week @ 2024-06-03 30/week @ 2024-06-10

424 downloads per month
Used in asciidork-cli

MIT license

11K SLoC

🤓 Asciidork

An Asciidoc parser/backend written in Rust


# requires rust/cargo toolchain
cargo install asciidork-cli
or install from source
git clone https://github.com/jaredh159/asciidork
cd asciidork
cargo build --release --bins

# vvvv -- OPTIONAL: or use rel path to `./target/release/asciidork` instead
sudo cp ./target/release/asciidork /usr/local/bin


# read the friendly manual
asciidork --help

# parse/convert/print from a file
asciidork --input test.adoc

# without a --input arg, it reads from stdin
echo "foo _bar_ *baz*" | asciidork
asciidork < test.adoc

# don't include enclosing document structure by passing `--embedded`
asciidork --input test.adoc --embedded

# send output to a file (alternatively just redirect stdout)
asciidork --input test.adoc --embedded --output test.html

# print information about perf (did i mention it's written in Rust btw?)
asciidork --input test.adoc --print-timings

# print pretty html (requires `pretter` -- install w/ `npm i -g prettier`)
asciidork --input test.adoc --embedded --format dr-html-prettier


The Asciidork parser and dr-html backend compiles to WASM to run in the browser! (Did I mention it's written in Rust?) NPM package coming soon, but for now you can see it in action here:


Be sure to pop the dev tools to see timing info.


[!WARNING] Asciidork is not complete. It implements a majority of the documented behavior of Asciidoc, but there are several unfinished areas, missing error handling, edge cases galore! Consider it a technology preview only for now.

Known unfinished or unimplemented areas include:

  • CSV Tables
  • STEM
  • Source highlighting
  • Include directives
  • All entity refs

PRs welcome! 👍


~59K SLoC