Is every Markdown file OKF?
No. It needs the OKF-style metadata and concept boundary.
Comparison
OKF vs Markdown
OKF is not a replacement for Markdown; it is a structured way to use Markdown for agent-readable knowledge bundles.
Quick comparison
Question
OKF
Other concept
One-sentence conclusion
Packages reusable Markdown knowledge files with frontmatter.
OKF is not a replacement for Markdown; it is a structured way to use Markdown for agent-readable knowledge bundles.
What it is
A draft format for structured knowledge bundles.
Markdown is a lightweight text format for headings, lists, links, code, and tables. OKF builds on that readability with frontmatter and bundle patterns.
Where it fits
Portable docs, API context, data notes, support playbooks, and agent context.
Plain documentation and notes.
Use together?
Can link to or describe the other artifact.
Yes. OKF uses Markdown as the body format and adds metadata at the top.
One-sentence conclusion
OKF is not a replacement for Markdown; it is a structured way to use Markdown for agent-readable knowledge bundles.
What it is
Markdown is a lightweight text format for headings, lists, links, code, and tables. OKF builds on that readability with frontmatter and bundle patterns.
Where it fits
- Plain documentation and notes.
- Git-based content editing.
- Static sites, READMEs, and developer docs.
Key differences
- Markdown alone does not require `type`, `title`, `description`, or `tags`; OKF uses frontmatter fields for discovery.
- Markdown can be one long page; OKF favors one concept per file.
- OKF adds bundle conventions so files can be scanned and linked predictably.
Can they work together
Yes. OKF uses Markdown as the body format and adds metadata at the top.
Example workflow
- Take an existing Markdown page.
- Add YAML frontmatter with type, title, description, resource, tags, and timestamp.
- Split broad pages into concept files and validate them.
FAQ
Can I convert Markdown to OKF?
Yes, but you still need to choose type, title, description, tags, and links.
Does OKF require a database?
No. A folder of Markdown files can be enough for a first bundle.
Related pages
- OKF Validator for checking frontmatter.
- OKF Templates for starter files.
- OKF Examples for bundle patterns.
Source boundary
This comparison uses official sources for definitions where available. Workflow recommendations are practical judgments, not official certification.