A command-line program that populates your markdown files with the output of documented code segments.
popmark, a simple library that populates your markdown files with the output of embedded Dart code segments.
Basic use #
To populate our markdown with the output of embedded code segments, we can run:
This gets popmark to search through the file for code segments marked
dart, execute those segments, and poplate the markdown file with
text blocks containing the respective segment output.
(We can use
--strip to remove all code output blocks.)
Using libraries and packages #
We can use
--imports to specify libraries or packages the code segments rely on.
Alternatively, we can specify a Dart template file, with necessary imports, using
--help for details.
popmark stores a json cache in a folder
.popmark (which we may want to tell our repo to ignore).
We can force popmark to execute code, whether or not it is cached, using
--refresh. (We can also force individual code segments to be executed by wrapping them in code blocks marked
dart! instead of
We can stop popmark from saving a cache, or making changes to an existing cache, using
(We can thus delete the cache by using both
--no-cache, or, of course, by simply running
rm -rf .popmark.)
- Be sure to save the target file before you unleash popmark on it.
- popmark overwrites any blocks marked
text... consider using unmarked blocks for text you do not want modified.
--output output.mdto create a new file rather than overwriting the target.
- If the implementation of the embedded code changes between runs, clear the cache (or mark segments
dart!) to force the segments to be executed.
Thanks for your interest in this project. Please file any issues here.