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.
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.
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\nFILE-CRLF: Produces Windows style\r\n
For more details and usage examples, have a look at examples/lineendings.md
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
Thanks to simonfxr for sharing the idea!