Полезные статьи
Зачем писать в Markdown, если есть Google Docs
Markdown хранится как plain text: его удобно версионировать в Git, диффить построчно и собирать в HTML, PDF или слайды одним пайплайном. Документы в облаке закрывают доступ при офлайне и усложняют автоматическую публикацию, если нет API.
Для технической документации связка Markdown + статический генератор снижает стоимость хостинга и ускоряет ревью через pull request.
- Один источник правды для сайта и README репозитория.
- Встраиваемые блоки кода с подсветкой из коробки в большинстве движков.
- Таблицы и чек-листы поддерживаются расширениями CommonMark/GFM.
- Меньше риска «сломать» вёрстку случайным перетаскиванием картинки.
- Экспорт в DOCX всё ещё возможен через Pandoc для юридического отдела.
Редактор на странице подходит для черновиков заметок и быстрых README без установки IDE.
Заголовки, якоря и оглавление для длинных текстов
Иерархия #…### создаёт навигацию и семантику. На GitHub заголовки автоматически получают якоря — удобно слать ссылку на раздел. Не прыгайте с # сразу на ### без ##: так деградирует доступность для скринридеров.
В превью редактора проверьте, что оглавление не дублирует название статьи сверху страницы.
- Длинные URL в ссылках лучше оборачивать угловыми скобками в некоторых движках.
- ID якорей должны быть уникальны — не копируйте один заголовок дважды.
- Для PDF добавьте явный разрыв страницы директивой генератора, а не десятьми пустыми строками.
- Якорь на кириллице кодируется в URL — тестируйте копирование.
Переключение «исходник / превью» в браузере экономит цикл правок.
Безопасность: когда Markdown опасен на сайте
Рендер чужого Markdown в HTML без санитизации открывает XSS через сырые <script> или javascript: в ссылках, если движок разрешает HTML. Публичный редактор для личных заметок безопаснее, чем приём пользовательского контента на сервере.
Если вы вставляете HTML в Markdown, знайте политику экранирования вашего пайплайна.
- Используйте allowlist тегов при серверном рендере.
- Отключите сырой HTML в пользовательском вводе по умолчанию.
- Для картинок проверяйте
data:URI — они раздувают DOM и память. - Ссылки на внешние ресурсы могут отслеживать IP — добавляйте
rel="noopener".
Локальный предпросмотр на нашем сайте не должен публиковать ваш текст без явной кнопки «поделиться», если такая появится в будущем — читайте политику.
Диаграммы Mermaid, математика KaTeX и совместимость
Расширения вроде fenced code block с языком mermaid или блоки $$ для формул поддерживаются не везде одинаково. Перед деплоем проверьте, что CI и прод используют одну версию плагина.
Редактор с базовым Markdown помогает отработать текст до переноса в систему, где диаграммы уже включены.
- Держите диаграммы рядом с объясняющим абзацем — не на другой странице.
- Сложные формулы дублируйте текстовым описанием для доступности.
- Экспорт в email часто ломает таблицы — имейте plain-text резерв.
- Для печати проверьте перенос длинных строк кода.
Хороший Markdown — это дисциплина структуры, а не гонка за количеством синтаксического сахара.
Онлайн Markdown редактор с превью
Бесплатный Markdown редактор с мгновенным превью. Пишите слева, результат видите справа. Поддерживаются заголовки, списки, код, цитаты, ссылки, таблицы и всё остальное.
Что такое Markdown
Markdown — язык разметки для форматирования текста. Используется в GitHub, документации, блогах, заметках. Простой и читаемый даже без рендеринга.