Что такое Markdown и зачем он нужен в заметках?

Базовый синтаксис

• # Заголовок, ## подзаголовок.
• **жирный**, *курсив*.
• - пункт списка, 1. нумерованный пункт.
• > цитата.
• [текст ссылки](адрес) — ссылка.
• `код` — моноширинный фрагмент.
• - [ ] задача, - [x] выполненная задача (расширение, которое поддерживают многие приложения).

Почему это удобно для заметок

Заметки в Markdown — обычные текстовые файлы. Они не зависят от конкретной программы: если сервис закроется или поменяет правила, файлы откроются в любом редакторе. Именно поэтому экспорт в Markdown — хороший признак того, что приложение не держит ваши данные в заложниках.

У исходного Markdown не было строгой спецификации, и разные программы понимали его чуть по-разному. Проект CommonMark предложил единую, однозначную спецификацию, а многие приложения добавляют свои расширения: например, Obsidian — ссылки [[вида]] и выделение ==так==.

Частые ошибки

• Ожидать, что расширения одного приложения сработают в другом.
• Забывать пустую строку перед списком — в некоторых редакторах он не распознается.
• Путать одинарную и двойную звёздочку.
• Считать, что Markdown — это язык программирования: это просто соглашение об оформлении текста.

Пример

Студентка уходит из приложения, которое перестало работать на её телефоне. Она выгружает 600 заметок в Markdown и открывает их в новом приложении: заголовки, списки и ссылки на месте. Переезд занимает вечер, а не неделю переписывания.

Как это устроено в Fast Notes

Fast Notes умеет выгружать все заметки в ZIP с Markdown, а также импортировать заметки из Notion, Obsidian, Google Keep и Bear.

Источники

• Daring Fireball: Markdown (Джон Грубер)
• CommonMark: спецификация Markdown
• Obsidian Help: базовый синтаксис форматирования