OKF Builder Reference / Open Knowledge Format v0.1, explained for builders OKF v0.1
OKF OpenKnowledgeFormat

Validator

Validate an OKF bundle

Paste Markdown, upload individual .md files, or select a folder. The validator checks OKF v0.1 concept-file rules and reports guidance for recommended metadata, timestamps, tags, and links.

Input

Validate Markdown.

.md only

Coverage

Checks parseable frontmatter, required concept types, recommended metadata, timestamps, tags, filenames, and internal Markdown links.

Version coverage

What the OKF v0.1 validator checks.

The validator separates required concept-file rules from metadata guidance so teams can fix blocking issues first and improve bundle quality next.

Review source references

Required checks

  • Concept files must contain parseable YAML frontmatter.
  • Frontmatter must be an object/map of keys and values.
  • Every non-reserved concept file needs a non-empty type.

Guidance checks

  • Recommended metadata includes title, description, resource, tags, and timestamp.
  • Tags should be an array for predictable filtering.
  • File-relative and bundle-root Markdown links are checked for missing targets.

Permissive behavior

  • Reserved files follow their index or dated-log body structures without concept frontmatter.
  • The root index.md may declare optional okf_version frontmatter.
  • Unknown fields and extension keys are allowed.
  • Non-Markdown files are ignored during validation.

Next step

Start from a known-good structure.

Mathias Onea

Mathias Onea

Senior Engineer, Product Builder, and Founder

Systems, product software, and practical execution for teams that need clear decisions, durable implementation, and agent-ready knowledge structures.

Focus
Knowledge systems, Laravel platforms, automation, and technical SEO infrastructure.
Related work
Founder-led software work through Craftwell and independent open-source projects.
Profile
mathiasonea.com