Markdown is a widely-supported plain-text format that reads cleanly in any editor and renders consistently across tools. Wikilayer stores every node body as markdown, parses it with goldmark + GFM, and adds a few project-specific extensions for cross-linking and embedded callouts.
Standard
Everything in CommonMark plus GitHub-Flavored Markdown:
- Headings (
#through######).#is reserved for the heading the renderer generates from each node's title; bodies start at the next level down (see agent rules). - Bold (
**text**), italic (*text*), strikethrough (~~text~~). - Inline code (
`text`) and fenced code blocks with an optional language tag. - Unordered lists (
-,*,+), ordered lists (1.), nested lists by indentation. - Blockquotes (
>). - Tables (GFM pipe syntax).
- Task lists (
- [x],- [ ]). - Horizontal rules (
---). - Links (
[text](url)) and images ().
Wikilayer extensions
A few forms get rewritten during render.
Page short refs
[text](page:N) resolves to the page's canonical /{owner}/{wiki}/{id}-{slug} URL. Slugs may rotate on rename; the id is stable.
Block short refs
[text](block:N) resolves to an in-page anchor #block-N on whichever page contains the block.
Callouts
GitHub-flavored admonitions render as styled boxes. The first line of the blockquote names the kind:
> [!NOTE]
> Body text.
Supported kinds: NOTE, TIP, IMPORTANT, WARNING, CAUTION. Each gets its own colour and icon.
Map embeds
A [!MAP] admonition with lat, lng on the next line embeds an interactive map widget. A third line, if present, becomes the caption.
> [!MAP]
> 44.7866, 20.4489
> Belgrade, the city centre.