OKF Export
Table of Contents
Open Knowledge Format (OKF) bundle - the same garden, flattened for agents - markdown paths, required type, no Hugo build.
Key Concept
- Authoring stays in Hugo (
[[wikilinks]], graph, flashcards); this bundle is the pass-off copy for ChatGPT, agents, and tools outside the site. - Open Knowledge Format (OKF) graph - visual network of the exported bundle.
- Open Knowledge Format (OKF) bundle.
- The same garden, flattened for agents - markdown paths, required type, no Hugo build.
- Regenerated on production build and via npm run export:okf.
- Authoring stays in Hugo; OKF is the agent-readable pass-off copy.
- The OKF bundle is the same garden flattened for agents - markdown paths, required type, no Hugo build.
ChatGPT workflow
Three lanes - all copy-paste friendly:
| Goal | Where | What to paste |
|---|---|---|
| Create a new atomic note | Create Note | Copy prompt → ChatGPT → paste the markdown file back into content/english/notes/ |
| Find connections between notes | Any note page (Random Note section) or Random Duo | Copy prompt - includes both note bodies + shortest wikilink path when one exists |
| Give context on existing notes | Copy MD or Agent copy on any note (upper right) | Paste into ChatGPT as background before asking questions |
Copy MD copies the full Hugo file (frontmatter + [[wikilinks]]) - ready to save or edit. Agent copy copies the Open Knowledge Format (OKF) version with resolved markdown links, better when the model doesn't know your wikilink titles.
For the whole garden at once: Copy catalog on this page, or open Bundle index.
Workflow combos
Each row maps to a site button plus a ChatGPT ask.
| Combo | Copy from site | Ask ChatGPT |
|---|---|---|
| Expand a hub (Maps of Content, MOC) | Copy hub cluster on a hub page (e.g. Maps of Content, Eternal Principles) + Copy catalog here | What atomic notes are missing from this cluster? Output Hugo markdown files. |
| Garden maintenance | Copy issues on Issues + Copy MD on 3-5 affected notes | Fix broken links, add extends/contradicts rows, keep voice plain. |
| Flashcard pass | Copy MD on a review: true spine note + Copy MD on Flashcards for format rules | Write six new scenario cards - cue on front, one-breath action on back. |
| Blog from note | Copy MD on the source note | Distill this into an 800-word blog post. Keep JoRap voice. No extra ## sections. |
| Post-Create siblings | Create Note prompt output (lists siblings automatically) | Run each sibling title as a new Create Note session |
| Orphan hunt | Filter Graph for orphans → Copy MD on 2-3 orphans + Copy catalog | What wikilinks and relationship rows would connect these to the rest of the garden? |
Standing context: paste Copy catalog once into a ChatGPT project. Add Copy MD or Copy hub cluster per session.
Browse the bundle
- Bundle index - all concepts and hubs (
okf_version: "0.1") - Update log - recent garden changes from git
- Example concept: Personal Knowledge Management (PKM)
- Example hub: Maps of Content
What changes in export
| Live garden | Open Knowledge Format (OKF) bundle |
|---|---|
[[wikilinks]] | [Title](/concepts/slug.md) |
| Hub/Maps of Content (MOC) pages | hubs/{slug}/index.md (no frontmatter) |
| Graph, Review, Flashcards | Omitted |
| Draft notes | Omitted |
| Canonical URL | resource: on each concept |
Regenerate bundle + graph: npm run export:okf (runs automatically on pnpm build).
Spec: Open Knowledge Format v0.1. Graph viewer adapted from Google's OKF reference visualizer. Pairs with Create Note, Random Duo, and Getting Started.
