← Documentation home

Canonical Markdown source · Oct 20, 2018

Definition

knowledge/concepts/open-knowledge-format.md · 48 lines · SHA-256 37e419de4736

Open Knowledge Format (OKF) is a draft v0.1 specification for packaging knowledge as a directory of Markdown files with YAML frontmatter. Its core purpose is interoperability: producers can write knowledge once, and humans or agents can consume it without a custom SDK.

Structure

| Element | Meaning |

|---|---|

| Knowledge bundle | A directory tree of Markdown files. |

| Concept | One non-reserved Markdown file representing one unit of knowledge. |

| Concept ID | The concept file path without the `.md` suffix. |

| Frontmatter | YAML metadata at the top of a concept file. |

| Body | Free-form Markdown, preferably structured with headings, lists, tables, and citations. |

| Link | A normal Markdown link that creates a directed relationship in the bundle graph. |

Conformance Boundary

For OKF v0.1, the hard conformance surface is intentionally small:

  • Non-reserved concept files need parseable frontmatter.
  • Concept frontmatter needs a non-empty `type`.
  • `index.md` and `log.md` are reserved files with special navigation/history roles.
  • Consumers should tolerate unknown types, optional fields, missing indexes, and broken links.

Meta Museum Usage

Meta Museum uses OKF as a project-knowledge layer under docs/knowledge(../index.md). This bundle is for agent-readable synthesis about standards, decisions, workflows, and evidence. It complements, but does not replace, the canonical project docs, Linked Art records, ActivityStreams evidence, or partner artifacts.

Related

  • LLM Wiki Pattern(llm-wiki-pattern.md)
  • Meta Museum Knowledge System(meta-museum-knowledge-system.md)
  • LLM Wiki Maintainer Schema(../schema/llm-wiki-maintainer.md)

Citations

[1] Open Knowledge Format v0.1 specification

[2] Google Cloud OKF announcement(../sources/open-knowledge-format-google-2026-06-12.md)