Unofficial OKF guide

Open Knowledge Format examples, validator, and templates

Learn how to package websites, docs, APIs, support playbooks, and data catalogs into AI-agent-readable knowledge bundles.

Try OKF Validator Copy OKF Template View OKF Examples

bundle/

index.md

pages/home.md

api/create-customer.md

--- type: Website Page title: OKF Validator tags: [okf, markdown] ---

What is OKF

Plain Markdown, small metadata, portable knowledge

Open Knowledge Format is useful when knowledge needs to stay readable by humans while also being easier for AI agents to scan, route, and retrieve.

Format

OKF uses plain Markdown files with YAML frontmatter so knowledge can stay readable without a special runtime.

Bundle

A folder of OKF documents can be shipped through Git, a zip archive, or any static file host.

Agent input

AI agents can scan titles, descriptions, tags, resources, links, and body sections before loading deeper context.

Why OKF matters

It makes source knowledge easier to inspect before an agent uses it

Without structure, a knowledge folder becomes another pile of text. OKF adds just enough metadata to identify what each file is, what it describes, where it came from, and how it connects to related concepts.

Useful for website pages, API endpoints, support workflows, documentation topics, and data assets.
Works with Git, static hosting, editors, search indexes, and retrieval systems.
Stays readable because the body is still normal Markdown.

How OKF works

Write one concept per file, then connect files with normal links

The frontmatter gives compact structured data. The Markdown body carries the explanation, examples, tables, citations, and links.

OKF minimum example

---
type: Website Page
title: Open Knowledge Format Validator
description: A browser-only tool that checks basic OKF frontmatter fields.
resource: https://openknowledgeformat.online/okf-validator/
tags: [okf, validator, markdown]
timestamp: 2026-06-17T00:00:00Z
---

# Purpose

This page helps users test whether a Markdown document includes the fields expected by this guide.

Validator

Paste Markdown and check whether the guide profile fields are present. The check runs in your browser.

Try OKF Validator

Templates

Copy starter frontmatter for websites, APIs, SaaS products, docs, agent context, and data catalogs.

Copy OKF Template

Examples

Review bundle shapes for real teams before building your own OKF folder.

View OKF Examples

Comparisons

OKF works beside nearby AI concepts

OKF vs MCP

MCP connects tools. OKF organizes knowledge. They can be used together.

Read comparison

OKF vs RAG

RAG retrieves context. OKF can make the source corpus cleaner before retrieval.

Read comparison

OKF vs llms.txt

llms.txt points to resources. OKF packages deeper structured knowledge.

Read comparison

FAQ

Open Knowledge Format questions

Is this an official OKF website?

No. This is an unofficial guide and is not affiliated with Google.

Does the validator upload my Markdown?

No. The validator runs in your browser for this MVP and does not upload pasted content to this site.

Is OKF a replacement for MCP or RAG?

No. OKF organizes knowledge. MCP connects tools and resources. RAG retrieves context for model answers.

What should I create first?

Start with one small bundle that covers important public pages, core API endpoints, or one support workflow.