OKF guide

Markdown to OKF

Convert Markdown into Open Knowledge Format files for AI agents, support bots, and internal search.

Markdown to OKF

Markdown to OKF conversion keeps plain Markdown readable while adding OKF metadata, required type fields, titles, descriptions, source URLs, stable filenames, and generated index navigation. The result is still portable Markdown, but it gives retrieval systems stronger signals for search, citation, validation, and agent workflows.

Why Markdown is the right starting point

Markdown is readable, portable, and easy to diff. OKF builds on that instead of hiding knowledge inside a closed database.

What conversion adds

The converter adds metadata, normalizes structure, creates output files, and validates the result before you load it into an AI system.

FAQ

Does Markdown to OKF replace Markdown?

No. OKF builds on Markdown. It keeps files readable while adding metadata and bundle structure that make the content easier for AI systems to retrieve.

Can OKF files live in Git?

Yes. OKF bundles are plain text files, so they can live in Git, move through pull requests, and be validated in CI.

Sources

Next step

Use OKFConverter to generate a structured bundle, then run the validator before giving the files to an AI agent, support bot, internal search system, or retrieval pipeline.