oku

oku ("read!" in Turkish) is a documentation kit. Pages are ordinary Markdown; charts, tables, diagrams and step flows are typed fences in that Markdown, and the browser renders them with Custom Elements. One command builds a multi-page site with search, an llms.txt for LLM readers, and a self-contained single-file copy of every page that opens from a mail attachment, follows the OS theme, and ships Mermaid, Prism and its fonts beside the output instead of loading them from a CDN.

The author keeps writing Markdown — GitHub, Obsidian and VS Code still render the prose, the tables and the Mermaid, and an oku-* fence shows there as readable JSON. oku check runs the schema, structure and presentation rules a reviewer would, and the build refuses a page that fails them.

It is what I write reports and design documents with, and its own documentation is built with it.