Links with meaning
Model relationships such as develops, depends-on, and interprets as data instead of burying them in prose.
A graph architecture for Hugo
Build knowledge,
not just pages.
Hugo Graph turns front matter into a portable network of typed entities, concepts, and relationships—without giving up the speed and simplicity that make Hugo great.
Plain YAML front matter. Static HTML output. No database or JavaScript required.
Why Hugo Graph
Pages tell stories. Graphs preserve meaning.
A normal link says where a reader can go. A typed relationship also records what two pieces of knowledge mean to each other—giving your content structure that templates, tools, and AI can understand.
Knowledge you own
Stable IDs and portable YAML keep the graph independent of filenames, URLs, themes, and even Hugo itself.
Hugo stays Hugo
Keep version-controlled content, fast builds, and static hosting. Add richer structure without adding a runtime database or CMS.
The source is the proof
This site is built with the architecture it explains.
Every entity, concept, and relationship in the demo comes from portable front matter and is resolved by Hugo at build time. The repository is intentionally small, so you can see the entire pattern without digging through a framework.
Start with one real node, follow it into the shared renderer, and you will understand how to adapt Hugo Graph to your own content.
node:
id: "apple"
type: "entity"
kind: "company"
relationships:
- predicate: "develops"
target: "iphone"