Документация

Синтаксис Markdown

Какой именно Markdown понимает Блокнотик — текст, списки, задачи, таблицы, код, картинки, — а также [[ссылки]] между заметками и #теги.

На этой странице
  1. Текст
  2. Списки и задачи
  3. Цитаты и код
  4. Таблицы
  5. Ссылки на сайты и картинки
  6. Ссылки между заметками
  7. Теги
  8. Что не поддерживается

Блокнотик читает обычный Markdown. Здесь перечислено ровно то, что понимают просмотр и экспорт в HTML. Всё остальное показывается как простой текст — ничего не теряется, просто не оформляется.

Текст

# Заголовок 1
## Заголовок 2
### Заголовок 3

Обычный текст. **Жирный**, *курсив* или _курсив_, ~~зачёркнутый~~,
`код` внутри строки.

Одиночный перенос строки внутри абзаца сохраняется — как напечатали, так и будет. Пустая строка начинает новый абзац. Заголовки бывают до шестого уровня; у каждого есть якорь, на который можно сослаться.

Три дефиса --- (или ***) на отдельной строке рисуют горизонтальную линию. Обратная косая черта отменяет особое значение символа: \*не курсив\*.

Списки и задачи

- пункт списка
- ещё один
  - вложенный, с отступом в два пробела

1. нумерованный
2. список

- [ ] открытая задача
- [x] выполненная задача

Маркерами могут быть -, * или +, номера заканчиваются на . или ). Нумерованный список может начинаться с любого числа. Флажки задач видны в просмотре, но в этой версии их там нельзя нажать — замените пробел на x в тексте.

Цитаты и код

> Цитата может занимать
> несколько строк.

Блок кода ограждается тремя обратными апострофами (или тремя тильдами). Слово после открывающих апострофов называет язык; оно сохраняется как метка, подсветки синтаксиса нет.

```python
print("привет")
```

Таблицы

| День | Мука         | Вода |
|------|--------------|-----:|
| Пн   | 50 г ржаной  | 50 г |
| Ср   | 50 г ржаной  | 45 г |

Вторая строка отделяет шапку. Двоеточие справа от дефисов выравнивает столбец по правому краю, с обеих сторон — по центру. Чтобы написать | внутри ячейки, используйте \|.

Ссылки на сайты и картинки

[текст ссылки](https://example.com)
https://example.com          ← голые адреса тоже становятся ссылками
![Фото закваски](картинки/закваска.jpg)

Ссылки на сайты открываются в новой вкладке браузера. Ссылками становятся только адреса http, https и mailto; всё остальное (например, javascript:) показывается как текст.

Картинка показывается, если файл лежит внутри папки с заметками. Путь считается от заметки: картинки/закваска.jpg у заметки в корне означает Blocknotik/картинки/закваска.jpg. Поддерживаются PNG, JPEG, GIF, WebP, SVG и AVIF. Картинки из интернета не загружаются — Блокнотик не делает запросов за пределы вашего компьютера, — вместо них в просмотре виден адрес.

Что пишетеЧто получится
[[Дневник закваски]]ссылка на заметку с таким названием
[[Дневник закваски|моя закваска]]то же, но текст ссылки — «моя закваска»
[[Дневник закваски#Кормление]]ссылка на заголовок «Кормление» в той заметке
[[#Кормление]]заголовок в текущей заметке
[[работа/Отчёт за квартал]]заметка во вложенной папке работа
[смотри](Другая заметка.md)обычная Markdown-ссылка на файл заметки

Регистр букв при сравнении не важен, ё и е считаются одной буквой. Название ищется во всех папках; если в разных папках есть заметки с одинаковым названием, побеждает та, у которой путь короче. Чтобы сослаться на другую, укажите в ссылке папку.

Ссылка на несуществующую заметку выделена красным. Щелчок по ней создаёт заметку в основной папке (косая черта в названии превратится в дефис).

При переименовании заметки [[ссылки]] на неё в других заметках переписываются. Обычные Markdown-ссылки вроде [смотри](Другая заметка.md) не обновляются — ещё одна причина предпочитать двойные скобки. Если в имени файла в Markdown-ссылке есть пробелы, пишите вместо каждого %20 или заключите путь в угловые скобки: [смотри](<Другая заметка.md>).

Теги

Тег — это #, за которым идут буквы, цифры, _, - или /, и хотя бы одна буква обязательна: #кухня, #прочитать, #планы-2026, #работа/отчёты. Знак # должен стоять в начале строки, после пробела или открывающей скобки, поэтому задача#3 и адреса сайтов с # тегами не считаются. Строка заголовка # Название — тоже не тег (после # пробел), но теги внутри заголовка считаются.

Регистр в тегах не важен, показываются они строчными буквами. Косая черта делает вложенные теги: поиск tag:работа найдёт и #работа/отчёты.

Что не поддерживается

  • HTML в заметках показывается как текст и никогда не выполняется. Так заметки из чужих источников остаются безвредными.
  • Front matter (блок YAML между --- в начале файла) не разбирается и выглядит как линии и текст.
  • Сносок, формул, диаграмм, списков определений и подсветки синтаксиса нет.