OKF is Google Cloud's open, vendor-neutral spec for representing knowledge as a directory of markdown files with YAML frontmatter — git-native, no SDK, consumable by any agent. Draftmark speaks it: export any doc as an OKF concept document, or any collection as an OKF bundle. Same markdown you already share, now in a format any agent framework can traverse.
LLMs work better with a curated, linked, maintainable library of markdown than with repeated document search. OKF formalizes what Obsidian vaults, AGENTS.md, and CLAUDE.md already do — into one portable standard.
A concept document needs only a type — a free string like Runbook or API Endpoint. Everything else (title, description, tags) is optional. Consumers tolerate anything.
A bundle is just a directory of .md files. Commit it, diff it, read it on GitHub. No database, no registry, no proprietary export format to reverse-engineer later.
Plain markdown plus YAML — parseable by any LLM or agent framework. No Google-specific SDK, no dependency. Works with Claude, GPT, open-source models, or anything that reads text.
Add .okf.md to any share URL — or ?format=okf on the API — and Draftmark wraps the markdown in OKF frontmatter. title, resource, and timestamp are synthesized; type, description, and tags come from the doc's meta.
Ask a collection for ?format=okf and Draftmark returns a bundle manifest — a generated index.md, a log.md changelog built from edit history, and one concepts/{slug}.md per member, ordered as you arranged them. Labels become the index entries, and links between members are rewritten to bundle-relative paths so the tree navigates offline. Want the whole thing as a file? Hit /c/{slug}.okf for a gzipped tarball you can tar -xz straight into a repo.
Anonymous exports include public docs only. A collection owner — with the magic token, API key, or owning account — gets private members too. Nothing leaks that the caller couldn't already read with the doc's own credential.
The output is plain markdown. Feed a concept doc into a prompt, stream a bundle into a vector store, or unpack the tarball into a repo your agents already read. Nothing about it is Draftmark-specific.
A collection is a directory of concepts. Its title heads the generated index.md; member order and labels drive the listing.
Each doc becomes one concepts/{slug}.md with synthesized frontmatter and its markdown body, untouched.
meta.type, meta.description, and meta.tags flow straight into the OKF fields. type defaults to Document.
The canonical share link becomes the concept's resource URI; the doc's last update becomes its timestamp.