Docs

Markdown syntax

The exact Markdown Blocknotik understands — text, lists, tasks, tables, code, images — plus [[links]] between notes and #tags.

On this page
  1. Text
  2. Lists and tasks
  3. Quotes and code
  4. Tables
  5. Web links and images
  6. Links between notes
  7. Tags
  8. What isn't supported

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 \|.

[the text](https://example.com)
https://example.com          ← bare addresses become links too
![A photo of the starter](images/starter.jpg)

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.

You writeIt 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.