OKF Tutorial
Use the main tutorial for the full workflow.
Open pageHow-to guide
How to create an OKF bundle
Create an OKF bundle by choosing a narrow scope, writing one concept per file, adding frontmatter, and linking files from an index.
Short answer
Create an OKF bundle by choosing a narrow scope, writing one concept per file, adding frontmatter, and linking files from an index.
Prerequisites
- A Markdown file or source page to convert.
- A clear concept boundary.
- A canonical source URL or stable resource identifier.
- Access to the OKF Validator for structure checks.
Step-by-step tutorial
- Choose one bundle scope.
- Create an index.md file.
- Add one concept file per page, endpoint, policy, or table.
- Validate frontmatter.
- Review sources and publish.
Copyable example
---
type: Knowledge Bundle
title: Website support bundle
description: Indexes support pages, policies, and contact workflows.
resource: https://openknowledgeformat.online/guides/how-to-create-an-okf-bundle/
tags: [okf, guide, example]
timestamp: 2026-06-21T00:00:00Z
---
# Purpose
Explain the stable facts, boundaries, owner notes, and related links for this concept.
# Links
- Validator: https://openknowledgeformat.online/okf-validator/
- Examples: https://openknowledgeformat.online/okf-examples/Common mistakes
- Trying to cover too many concepts in one file.
- Leaving metadata blank or vague.
- Treating validation as proof that every claim is correct.
- Publishing private or unreviewed information.
Validation method
- Paste the file into the OKF Validator.
- Fix errors before warnings.
- Check links and source claims manually.
- Add the file to the bundle index.
Related page links
- OKF Tutorial for the full beginner workflow.
- OKF Examples for bundle structures.
- OKF Templates for copyable starting points.
FAQ
Common questions
Does this require a database?
No. A folder of Markdown files is enough for the first version.
Can I automate this?
You can generate drafts, but owners should review source accuracy and boundaries.