OKF Tutorial
Use the main tutorial for the full workflow.
Open pageHow-to guide
How to link OKF concept files
Link OKF concept files with ordinary Markdown links and keep each link tied to a clear relationship.
Short answer
Link OKF concept files with ordinary Markdown links and keep each link tied to a clear relationship.
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
- List related concepts.
- Use relative Markdown links inside the body.
- Avoid unrelated link blocks.
- Add source URLs when needed.
- Check links during review.
Copyable example
---
type: Concept Link
title: Pricing and refund policy links
description: Shows how one OKF file links to related policy and support files.
resource: https://openknowledgeformat.online/guides/how-to-link-okf-concept-files/
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.