DEPT·F1 — TOOLING & PLATFORM2025 - 2026
MD Mermaid PDF
CLI that renders Markdown with Mermaid diagrams straight to PDF, engineered with TDD, mypy strict and CI.
The brief
Docs with diagrams rot when the toolchain is manual. This CLI makes the Markdown→PDF step a one-command, reproducible build — diagrams included.
What was built
Markdown in, PDF out: one command renders the document and its Mermaid diagrams.
Engineered with TDD: the test suite came before the renderer.
mypy strict typing and GitHub Actions CI keep every push honest.
Field notes
- ONE COMMAND
Markdown in — PDF out, with the Mermaid diagrams rendered and embedded.
- QUALITY
A feature, not an afterthought: full TDD suite and mypy strict typing.
- SHIPS WITH
GitHub Actions CI on every push.
STACK
PythonMarkdownMermaidGitHub Actions