Tech Stack

This site is a git-backed static site built from Markdown files and Excalidraw diagrams. For the full design rationale, see the PKB Tech Stack document.

Static site generator¶

• MkDocs with Material for MkDocs as the theme

MkDocs plugins¶

• mkdocs-awesome-pages-plugin — flexible navigation ordering without maintaining a full nav tree
• mkdocs-excalidraw — client-side rendering of .excalidraw diagrams with automatic light/dark mode support
• mkdocs-obsidian-support-plugin — converts Obsidian callouts to Material admonitions
• mkdocs-backlinks-section-plugin — automatic backlink sections
• mkdocs-glightbox — image lightbox support

Tooling¶

• uv — Python toolchain (manages Python version and dependencies)
• Git LFS — large file storage for .excalidraw files
• Pre-commit — enforces markdown quality, link integrity and repository hygiene (see Editing Conventions and Local Dev Environment for setup)

CI / CD¶

On push to main, a GitHub Actions workflow builds the site with uv run mkdocs build --strict and deploys it to GitHub Pages.

Backlinks¶

The following pages link to this page:

• About This Site
• Editing Conventions