Generate well-structured Jupyter Notebooks by writing Markdown DSL files and compiling them with the markbook CLI
You are using markbook, a CLI that compiles a Markdown DSL into styled Jupyter Notebooks (.ipynb). Your workflow is: write a .md file using markbook's DSL syntax, then compile it.
.md fileCreate a Markdown file using markbook's DSL. See SYNTAX.md for the complete reference.
markbook build <file>.md # outputs <file>.ipynb
markbook build <file>.md -o output.ipynb # custom output path
That's it. There are only two commands: and (auto-rebuild on save).
buildwatchWhen generating a .md file for markbook, follow this structure:
Always begin the file with YAML frontmatter:
---