#mdbook #pic #markdown #md #pikchr

app mdbook-pikchr

A mdbook preprocessor to render pikchr code blocks as images in your book

11 releases

0.2.0 Nov 18, 2025
0.1.9 Nov 6, 2024
0.1.8 Oct 23, 2024
0.1.7 Oct 2, 2023
0.1.4 Oct 22, 2022

#525 in Text processing

MIT license

300KB
7K SLoC

C 7K SLoC // 0.1% comments Rust 258 SLoC

mdBook Pikchr

A mdBook preprocessor to render Pikchr code blocks as images in your book.

Taken from the Pikchr homepage:

Pikchr (pronounced like "picture") is a PIC-like markup language for diagrams in technical documentation. Pikchr is designed to be embedded in fenced code blocks of Markdown (or in similar mechanisms in other markup languages) to provide a convenient means of showing diagrams.

This crate use builtin copy of the pikchr.c file downloaded from that website.

How it's work

Installation

Install it via cargo:

$ cargo install mdbook-pikchr

Configuration

Just type next line in your book.toml file:

[preprocessor.pikchr]

Source code

Source code available on GitHub.

Dependencies

~10–14MB
~187K SLoC