OKF Export
Table of Contents
Same garden flattened for agents - markdown paths, required type, no Hugo build.
Key Concept
- Authoring stays in Hugo; OKF is the agent-readable pass-off copy outside the site.
- Same garden, flattened - markdown paths, required type field, no Hugo build step.
- Regenerated on production build and via npm run export:okf.
Level 1 - Recognize
OKF export is a flat markdown bundle of the same garden - paths, types, no Hugo build required.
Level 2 - Explain
Like photocopying your notebook for a friend who uses a different app - same content, agent-readable shape.
Level 3 - Use
When an agent or script needs current note text, regenerate OKF after garden edits instead of parsing the site.
Level 4 - Connect
Keep Hugo as source of truth - stale exports mislead automation; refresh on production build or npm run export:okf.
Level 5 - Create
Build a downstream tool on the OKF handoff, extend its required type and path fields when the tool needs more context, and keep Hugo as the editable source for Building a Personal API.
Open Knowledge Format (OKF) graph - visual network of the exported bundle.
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
- Open Knowledge Format (OKF) graph - Cytoscape force layout, search, backlinks
- Bundle index - all concepts and hubs (
okf_version: "0.2") - 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.2. Graph viewer adapted from Google's OKF reference visualizer. Pairs with Create Note, Random Duo, and Getting Started.
