markli
markli (from markdown literator) is a simple commandline tool to support literate programming. It's main focus is better support for setup scripts that configure build machines or there alike. Basically you have much more documentation than actual code.
Basic Usage
This utility has a simple commandline syntax:
markli -i your-markdown.md -o output-folder
When called like this, all code-blocks containing ###FILE:
within the first line will be converted into standalone files contained within output-folder
.
Line Endings
For certain things, e. g. Bash Scripts, you want to be able to explicitely control the line ending of the output file. You can use the following pragma extensions to achieve this:
FILE-LF
: Produces unix style \n
FILE-CRLF
: Produces Windows style \r\n
For more details and usage examples, have a look at examples/lineendings.md
Examples
See the examples folder for basic use cases and features of markli.
Note: These example files are also used as tests, see examples_test.go
Acknowledgements
Thanks to simonfxr for sharing the idea!