Skip to content

A literate programming tool that allows writing code in Markdown files.


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



43 Commits

Repository files navigation


A literate programming tool that allows writing code in your Markdown files.


Build License Version Version

How it works

At its core literate reads a file from standard in and outputs code blocks to standard out as a single stream. The code blocks may be filtered by various qualities such as language, attributes, etc.

The real magic

Although literate itself is very simple, the magic really happens when you apply the tool to entire directories. For example, a Rust project could add literate to their in order to write their examples as Markdown files that become Rust files at build time. Since Rust has a very mature documentation culture, the actual source may not benefit as much from literate. However, one can easily envision a tool that flips Rust's documentation on its head. Instead of doc comments, Rust source could be defined as Markdown files. During build, the file could be parsed to add the surrounding text as a doc comment to the code block code. User's could plug in different strategies for traversing up the tree to find the relevant documentation.


cat .\examples\ | literate --language tortuga --required