markdown-tool

markdown-tool is a simple command-line utility for converting Markdown documents to various formats and abstract syntax tree (AST) representations, and vice versa.

Features

• Convert between Markdown, HTML, JSON-based AST, and YAML-based AST formats
• Lightweight, zero-dependency CLI
• Easily scriptable in CI/CD workflows or shell scripts

Installation

Install via crates.io (requires Rust and Cargo):

cargo install markdown-tool

Alternatively, download pre-built packages:

• Debian (.deb):

  sudo dpkg -i markdown-tool_<VERSION>_<ARCH>.deb
  

Usage

Usage: markdown-tool convert --from <FROM> --to <TO>

Options:
      --from <FROM>  Inbound document format. Possible values are: `markdown`, `ast-json`, and `ast-yaml`
      --to <TO>      Outbound document format. Possible values are: `markdown`, `html`, `ast-json`, and `ast-yaml`

Supported Formats

Examples

Convert a Markdown file to JSON AST:

markdown-tool convert --from markdown --to ast-json < input.md > ast.json

Convert a Markdown file to HTML string:

markdown-tool convert --from markdown --to html < input.md > output.html

Convert JSON AST back to Markdown:

markdown-tool convert --from ast-json --to markdown < ast.json > output.md

Convert YAML AST to Markdown:

markdown-tool convert --from ast-yaml --to markdown < ast.yaml > output.md

Pretty-print Markdown:

markdown-tool convert --from markdown --to markdown < unformatted.md > formatted.md

📚 Documentation

• AI-generated documentation

Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request on GitHub.

License

Dual-licensed under MIT. See LICENSE for details.