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.
  • Bundle-relative Markdown links are checked for missing targets.

Permissive behavior

  • Reserved files such as index.md and log.md do not require a type.
  • Unknown fields and extension keys are allowed.
  • Non-Markdown files are ignored during validation.

Next step

Start from a known-good structure.