Editing pages: blocks, tables, code and diagrams
Open a page and press Edit. The page becomes an editor that works in blocks: click into a paragraph and change it, or start a new block with the slash menu. Blocks is the default view; Source shows the markdown underneath. ⌘S saves, and so does the Save button.
Everything you write is stored as markdown, which is what your agents read and write over MCP. The editor is a way of writing that markdown without looking at it.
Blocks and the slash menu
An empty block reads Write, or type / for a block. Type / and pick:
| Block | What it is |
|---|---|
| Text | A paragraph |
| Heading 1 – Heading 6 | Section headings — ## and ### are the ones a wiki page usually needs |
| Bullet List, Ordered List | Lists; press Tab to nest |
| Task List | Checkboxes |
| Quote | A pulled-out passage |
| Divider | A horizontal rule |
| Code | A fenced code block with a language |
| Table | A table you can add rows and columns to |
| Diagram | A Mermaid code block with a rendered preview under it |
Drag a block by its handle to move it. Select text for the inline toolbar — bold, italic, code, a link. Paste markdown and it arrives as blocks, not as a wall of text.
Links between pages
Type [[ and a picker opens over the pages in this project; keep typing to
filter by path, press Enter to insert [[path]]. Write
[[path|display text]] by hand when the prose should read differently from
the path. These are wikilinks — the same links your agents write — and they
are what builds the link graph and what wiki_lint checks. A link inside a
code block or inline code is text, not a link.
Code and diagrams
A Code block takes a language; the read view highlights it and shows the language in the corner. A Diagram block is a code block in the Mermaid language: write the diagram source and a rendered preview appears under it (Hide diagram folds it away; Edit brings the source back). Flowcharts, sequence diagrams, pies, git graphs and state diagrams all work, and the read view renders them in colour.
Tables
A Table block is a real table. In the read view a table wider than the column scrolls sideways rather than squeezing the page.
What is deliberately off
Images and math (LaTeX) are switched off in the editor. A wiki page is text that people and agents both write; a file you need to keep belongs in Sources, which your agents can read. This may change.
Source
Source shows the page's markdown and lets you edit it directly. Switch back to Blocks at any time.
Some pages open in Source on their own, with a note naming the line: it means the block editor would change that line's spelling — a table alignment marker, an unusual list marker, an HTML block — and WitWiki would rather show you the markdown than silently rewrite it. Edit the line and Blocks becomes available.
Saving
Press ⌘S or Save. A save only rewrites the blocks you changed, so a one-word edit is a one-line diff in History, and an agent reading the page afterwards sees exactly what moved. Every save carries the version you opened with; if the page changed while you were editing — usually an agent — the editor shows the change and asks what to do. See History and conflicts.
New pages
On any page, + new page creates a page linked from the one you are on:
give it a path like concepts/my-new-topic, and WitWiki creates it, adds a
[[concepts/my-new-topic]] link to the current page, and opens the new page
in edit mode. Paths are lowercase, hyphenated, use / for hierarchy, and
never end in .md; the title starts as the last segment and you can change
it. Agents create pages over MCP with wiki_updatePage, and change them with
wiki_patchPage against the version they read.
Related
- Structuring a wiki — paths, one topic per page, and what is worth writing.
- History and conflicts — what happens when two writers meet.
- Your first hour — the first edit, in context.