Docs
Markdown syntax
The exact Markdown Blocknotik understands — text, lists, tasks, tables, code, images — plus [[links]] between notes and #tags.
On this page
Blocknotik reads ordinary Markdown. This page lists exactly what the preview and the HTML export understand. Anything else is shown as plain text — nothing is lost, it just isn't formatted.
Text
# Heading 1
## Heading 2
### Heading 3
Plain text. **Bold**, *italic* or _italic_, ~~struck through~~,
`code` inside a line.
A single line break inside a paragraph is kept as a line break, the way you typed it. An empty line starts a new paragraph. Headings go up to level six; each one gets an anchor you can link to.
Three dashes --- (or ***) on their own line draw a horizontal rule. A backslash escapes a character that would otherwise mean something: \*not italic\*.
Lists and tasks
- bullet item
- another one
- nested, indented by two spaces
1. numbered
2. items
- [ ] open task
- [x] done task
Bullets can be -, * or +; numbered items can end with . or ). A list may start with any number. Task boxes are shown in the preview but can't be clicked there in this version; change the space to x in the text.
Quotes and code
> A quote can span
> several lines.
Code blocks are fenced by three backticks (or three tildes). A word after the opening fence names the language; it's kept as a label, there is no colouring.
```python
print("hello")
```
Tables
| Day | Flour | Water |
|-----|-----------|------:|
| Mon | 50 g rye | 50 g |
| Wed | 50 g rye | 45 g |
The second line separates the header. A colon on the right of the dashes aligns the column to the right, on both sides — centres it. To use | inside a cell, write \|.
Web links and images
[the text](https://example.com)
https://example.com ← bare addresses become links too

Web links open in a new browser tab. Only http, https and mailto addresses become links; anything else (such as javascript:) is shown as text.
Images are shown if the file lies inside the notes folder: the path is relative to the note, so images/starter.jpg next to a note in the root folder means Blocknotik/images/starter.jpg. PNG, JPEG, GIF, WebP, SVG and AVIF work. Images from the internet are not loaded — Blocknotik makes no requests outside your computer — the preview shows their address instead.
Links between notes
| You write | It means |
|---|---|
[[Sourdough log]] | link to the note with this title |
[[Sourdough log|my starter]] | the same, but the link reads “my starter” |
[[Sourdough log#Feeding]] | link to the heading “Feeding” in that note |
[[#Feeding]] | heading in the current note |
[[work/Quarterly report]] | note in the subfolder work |
[see](Other note.md) | a normal Markdown link to a note file |
Matching ignores case (and treats ё as е). Titles are looked up in all folders; if two notes in different folders share a title, the one with the shorter path wins — write the folder in the link to pick the other one.
A link to a note that doesn't exist is shown in red. Clicking it creates the note in the main notes folder (a slash in the title becomes a dash).
When you rename a note, [[links]] to it in other notes are rewritten. Ordinary Markdown links like [see](Other note.md) are not updated — another reason to prefer double brackets. For a Markdown link to a file name with spaces, write %20 for each space or wrap it in angle brackets: [see](<Other note.md>).
Tags
A tag is # followed by letters, digits, _, - or /, with at least one letter: #kitchen, #to-read, #2026-plans, #work/reports. The # must be at the start of a line or after a space or an opening bracket, so issue#3 and web addresses with # are not tags. A heading line # Title is not a tag either (there's a space after #), but tags inside a heading count.
Tags are case-insensitive and shown in lower case. The slash makes nested tags: searching for tag:work also finds #work/reports.
What isn't supported
- HTML in notes is shown as text, never executed. This keeps notes from other places harmless.
- Front matter (a
---block with YAML at the top) is not interpreted; it appears as rules and text. - Footnotes, math formulas, diagrams, definition lists and syntax highlighting are not there.