Хорошая типографика незаметна: глаз не спотыкается. В Markdown нет полной власти InDesign, но базовые правила русского набора всё ещё работают 📘

Кавычки и тире #

НужноПишите
Кавычки«ёлочки» для русского, "code" только в коде
Тиредлинное тире — — (или -- если конвертер сам поправит)
Дефисв словах «кто-то», не вместо тире
Многоточие… или три точки ... единообразно по сайту

В Hugo часто помогают smartypants / goldmark extensions — но не полагайтесь на них в code fence.

Абзацы и воздух #

  • 3–6 строк на абзац в вебе — комфортно.
  • Одна идея — один абзац.
  • Подзаголовки ## / ### каждые 200–400 слов, если тема плотная.

Списки #

Используйте список, если есть перечисление однородного. Если это связный рассказ — абзацы.

Плохо: список из одного пункта.
Плохо: нумерация, где порядок не важен (берите маркеры).

Код в тексте #

Инлайн: kubectl get pods — для имён команд и полей.
Блок — для того, что копируют. Не оборачивайте прозу в backticks.

Числа и единицы #

10 ГБ, 3 часа, 8080/tcp

Неразрывный пробел между числом и единицей идеален, но в MD его легко убить. Хотя бы не переносите 10 на одну строку, а ГБ на другую вручную в узких колонках (preview!).

Доступность #

  • Смысл не только цветом (в callout дублируйте словом «Важно»).
  • У картинок — alt.
  • Контраст кода зависит от темы сайта — проверьте light/dark.

Итог #

«Ёлочки», нормальные тире, короткие абзацы, код только там где код. Этого хватает, чтобы пост не выглядел машинным переводом ✨