Skip to content

The Markdown spec yourAI agents can actually read.

An open spec for knowledge bases that live in git, render anywhere, and feed AI agents natively. 3 rules. No runtime. No lock-in. Don't let your docs rot outside your agent's context.

Read the Spec — just 5 min Build Your First Bundle →
📐 Based on the Google Cloud Markdown spec 🔓 MIT licensed 🛠️ Used by teams shipping AI-powered docs

Features

Just Markdown. Zero new tools.

A directory of .md files with YAML frontmatter. No SDK, no build step, no dependencies. Your editor already supports it — you just didn't have a spec until now.

Validate in Seconds — catch errors before your agent does

Paste or upload a bundle. Check conformance against 3 simple rules — right in the browser. Zero backend, zero install. Know your bundle is correct before shipping.

Agent-Ready from Day One — no prompting gymnastics

Install a skill that teaches Claude, Codex, or Cursor to produce conformant bundles. Your AI agents ship correct output without custom instructions or fragile system prompts.

Why teams are switching to OKF

3 rules, not 300.

Other specs need a PhD to implement. OKF needs 5 minutes.

Git-native.

Diff, branch, review knowledge like code. No proprietary format holding your content hostage.

Agent-first.

AI agents parse OKF bundles without adapters or middleware. Zero glue code.

v0.1 stable. Semver promise.

Breaking changes follow semver. Early adopters won't be punished.

Example Bundle — this is all it takes

Code example

▸ my-knowledge-bundle/
  ├── index.md
  ├── what-is-okf.md
  └── validation-rules.md

---
type: concept
title: What is OKF
---

# What is OKF
The Open Knowledge Format is a spec for
representing knowledge as markdown files...

Ship your first bundle in 2 minutes.Not hours. Not "coming soon."

Or keep copy-pasting into system prompts.

Build Your First Bundle → or view on GitHub →