pages

---

title: Pages type: concept

Pages

A page is just a markdown file on disk under your wiki directory.

~/.mind-map/wiki/
├── index.md
├── projects/
│   └── mind-map.md
└── design/
    └── rationale.md

The path (without .md) is the page's identifier: projects/mind-map, design/rationale, etc. That's what concepts/wikilinks target, what the agents/mcp-tools take as arguments, and what shows up in the architecture/web-ui sidebar.

File anatomy

---
title: My Page
type: project
status: active
---
# My Page

Body text. May contain [[wikilinks]] and ![[images]] and standard markdown.

• The --- block is optional concepts/frontmatter.
• The first # Heading is the canonical title if no frontmatter title: is given.
• Standard CommonMark, plus mermaid code blocks for diagrams and [[wikilinks]].

Lifecycle

graph LR
    W[Write file] --> I[Index]
    I --> S[Search]
    I --> G[Graph]
    I --> B[Backlinks]
    E[Edit file] --> I
    D[Delete file] --> I

Loading

The architecture/wiki-engine watches for changes; the architecture/index-and-search re-syncs incrementally — only pages whose mtimes have changed get re-parsed.

Moving pages

Renaming a page used to be risky (file-rename + create-elsewhere left orphans). agents/mcp-tools is an atomic rename that updates the index and link table in one step. See guides/refactoring-a-wiki.