# Use Markdown
Zaphiri supports **markdown** in personal Notes, Project Docs, and task descriptions. It’s a fast way to format text as you type: no menus, no breaking your flow.
For toolbar-based formatting such as text colour, inline images and link editing, see [[Rich Text Editing]].
> [!quote] Simple formatting
> Good formatting makes information easier to read and faster to understand. Markdown brings clarity to your thoughts.
---
## Basic examples
- `**bold text**` → **bold text**
- `# Header` → Large header
- `- List item` → • List item
---
## Headers
- `#` + Space → Large header
- `##` + Space → Medium header
- `###` + Space → Small header
Example:
# Large Header
## Medium Header
### Small Header
---
## Lists
- `-` + Space → Bulleted list
- `1.` + Space → Numbered list
- `[]` + Space → Checklist
Example:
- First bullet
- Second bullet
1. First numbered
2. Second numbered
[] Task to complete
---
## Text styling
- `**bold**` → **bold**
- `~italic~` → *italic*
- `~~strike~~` → ~~strike~~
- `` `code` `` → `code`
- `---` → line break
Example:
**Bold text**
~Italic text~
~~Strikethrough~~
`Inline code`
---
---
## Blockquotes and code blocks
- `>` + Space → Quote
- `` ``` `` → Code block
Example:
> This is a blockquote
> Use for key information
```
Code block for snippets or structured notes
```
Code blocks pick up syntax highlighting and line numbers automatically. See [[Rich Text Editing]] for the full set of code block controls.
---
## Where markdown works
- **Notes** → General notes, daily notes, all projects
- **Project Docs** → Shared plans, decisions, and reference material
- **Task descriptions** → Add structure, lists, references
---
## Tips for clean formatting
> [!tip] Best practices
> - Break up long content with headers
> - Use lists for steps or grouped ideas
> - Bold the most important words
> - Quote key takeaways
> - Don’t overdo it: clarity beats decoration
---
Markdown keeps your writing clean and readable while letting you stay in flow. The formatting happens automatically, so you can focus on your ideas.
---
**Next:** Use markdown while writing in [[Adding Notes]].