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.
- Level 1: You write notes in Hugo on the site - OKF is a flat copy outside the site that other tools can read, like photocopying your notebook for a friend who uses a different app.
- Level 2: OKF export is the agent-readable pass-off - authoring stays in Hugo, flat copy lives outside for other tools.
- Level 3: Authoring stays in Hugo; OKF is the structured export agents and scripts can ingest without parsing the site.
- Level 4: Keep Hugo as source of truth - regenerate OKF when the garden changes so external tools read current text.
- Level 5: Building a Personal API and automation assume a stable export format - OKF is the handoff layer, not a second place to edit.
- Same garden, flattened - markdown paths, required type field, no Hugo build step.
- Regenerated on production build and via npm run export:okf.
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.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.
