Markdown Guide
A comprehensive guide to Markdown formatting in Rhizome.
Markdown Guide
Rhizome supports GitHub Flavored Markdown (GFM) for rich text formatting.
Text Formatting
Basic inline formatting:
- Bold text using double asterisks
- Italic text using single asterisks
Strikethroughusing double tildesInline codeusing backticks- Highlight using HTML
<mark>tags
Headings
Use # symbols for headings. The frontmatter title becomes the page title, so start content with ## for sections.
## Section
### Subsection
#### Sub-subsection
Lists
Unordered Lists
- First item
- Second item
- Nested item
- Another nested item
- Third item
Ordered Lists
- First step
- Second step
- Third step
Task Lists
- Completed task
- Incomplete task
- Another task
Wiki-Links
Wiki-links are the primary way to connect notes in Rhizome:
| Syntax | Result |
|---|---|
[[Note Title]] | Links to note by title |
[[Note Title|display text]] | Shows "display text" but links to note |
[[Note#Section]] | Links to specific heading in note |
[[Note#^block-id]] | Links to specific block by ID |
[[Note#Section|display text]] | Anchor link with custom text |
[[Knowledge Graph Basics]] | Knowledge Graph Basics |
[[Knowledge Graph Basics|learn about graphs]] | learn about graphs |
[[Embeds and Anchors#Heading Anchors]] | Embeds and Anchors |
Wiki-links are case-insensitive. [[welcome to rhizome]] and [[Welcome to Rhizome]] link to the same note.
Clicking a wiki-link opens it in a split pane, letting you view both notes side-by-side. See Split-View Navigation for more.
For advanced features like embedding notes inline (![[...]]), see Embeds and Anchors.
Links and Images
Standard markdown links work alongside wiki-links:
- External link opens in a new tab
- Wiki-links connect notes by title: Welcome to Rhizome
- Use standard markdown syntax for images:
\
Images are placed in content/assets/ and referenced as:
Tables
| Feature | Status | Description |
|---|---|---|
| Wiki-links | ✅ | Connect notes by title |
| Backlinks | ✅ | See incoming connections |
| Tags | ✅ | Organize by topic |
| Search | ✅ | Full-text search |
| Graph | ✅ | Visualize connections |
Alignment can be controlled with colons:
| Left | Center | Right |
|:-----|:------:|------:|
| L | C | R |
Blockquotes
The best way to predict the future is to invent it.
— Alan Kay
Use blockquotes for highlighting quotes or important notes.
Nested blockquotes work too:
First level
Second level
Horizontal Rules
Use three dashes to create a section break:
Code Blocks
See Code Blocks for syntax highlighting examples.
Escaping
To display literal characters that have special meaning:
\*not italic\*→ *not italic*\[not a link\]→ [not a link]`inline code with *asterisks*`→inline code with *asterisks*
Frontmatter
Every note begins with YAML frontmatter:
---
title: "Note Title"
date: "2026-02-12"
type: "note"
tags: ["tag1", "tag2"]
summary: "A brief description shown in listings and search."
---
| Field | Required | Description |
|---|---|---|
title | Yes | Note title (used for wiki-links) |
date | No | Publication date (YYYY-MM-DD) |
type | No | note or article (default: note) |
tags | No | Array of tags for organization |
summary | No | Brief description for listings |
updated | No | Last update date |
status | No | draft, published, etc. |
private | No | If true, excludes from build |