Markdown is plain text with a few characters for structure: # for headings, - for lists, [Text](address) for links. A Markdown file can be opened in any editor and will still be readable in twenty years.
Frontmatter
A file can start with a block of structured data, the frontmatter. It is written in YAML and enclosed by three hyphens. On this website it holds a node's title, type, summary and relations.
Why it works as a long-term format
- No vendor, no subscription, no export needed.
- Versionable with Git: every change can be traced.
- Every website build tool can read it.
- Basis for
-
- How an LLM Wiki Works How an LLM wiki works, shown on this knowledge base: Markdown in its own Git repository, a Python tool with MCP for agents, and a website that only displays it.
- Markdown as a Database For a personal website, a folder of Markdown files with a structured header replaces the database, as long as a schema checks it.
- Open Knowledge Format Vendor-neutral format from Google Cloud for knowledge that people and agents share: a directory of Markdown files with YAML frontmatter.
- Used in
-
- Astro Tool for building websites from content such as Markdown. Ships plain HTML by default and only loads JavaScript where it is needed.
- Obsidian Wiki-Links in Astro with a Remark Plugin A small Remark plugin that turns Obsidian [[wiki-links]] into normal links at build time, with labels, heading anchors and a fallback for unknown targets.
- Tags