Marky

Markdown Magician 🧙

Features

Note When converting to PDF it will automatically download a suitable headless chrome binary if one is not present on your system. Everything is automated!

- Examples - Install - Help - Build - Screenshots

Examples

Convert doc.md to doc.html

bash marky doc.md

Convert to PDF

bash marky doc.md --pdf

Start a local preview server with hot-reload

bash marky doc.md --live

Enable extensions

```bash

Or use --all to enable all

marky doc.md --math --diagrams --highlight ```

Include local images as base64 encoded (beta)

```bash

default: none, possible values: none, local, remote, all

marky doc.md --include-images local ```

Select and use a different theme with fzf

bash marky doc.md --theme $(marky --themes | fzf)

Pipe from stdout and open compiled file

bash cat doc.md | marky --out doc.html --open

See --help for more info

Install

Install using cargo

bash cargo install marky

Help

``` Usage: marky [OPTIONS] [PATH]

Arguments: [PATH] Read input from file

Options: --completion [possible values: bash, elvish, fish, powershell, zsh] -t, --theme Theme to use --string Read input from string --themes List available themes --where-config Print config path -o, --out Output file --stdout Output to stdout -H, --highlight Enable syntax highligting with highlight.js -M, --math Enable math rendering with KaTeX -D, --diagrams Enable UML diagrams rendering with Mermaid -A, --all Enable all extra renderers -w, --watch Recompile file on save -l, --live Live preview in the browser --port Port of the live server [default: 8080] -O, --open Open output file in the default app -p, --pdf Saves document as PDF, will auto-download headless-chrome -h, --help Print help -V, --version Print version ```

Build

bash git clone https://github.com/metafates/marky.git cd marky cargo install --path .

Screenshots

Some examples...

bash marky README.md --theme sakura # default theme sakura

bash marky README.md --theme air air

bash marky README.md --theme retro retro

See marky --themes to show all available themes.

You can also your own themes, but it's not documented yet... 😴