Markdown прост, пока не встретите таблицу в списке и raw HTML в Goldmark. Шпаргалка под блоги и документацию 📝

Каркас, который читают #

## Заголовок раздела

Короткий абзац — одна мысль.

- список
- только если пунктов ≥2

| Колонка | Смысл |
|---|---|
| A | … |

Заголовки — с # и пробелом. В body постов Hugo заголовок H1 уже из title — начинайте с ##.

Code fence всегда с языком #

```bash
hugo --minify
```

Без языка подсветка и копирование в теме работают хуже. Для «просто текста» — text / plaintext.

Ссылки и якоря #

[текст](https://example.com)
[раздел](#заголовок-раздела)

Hugo/Goldmark транслитерирует кириллические якоря — проверяйте preview, не угадывайте slug.

Картинки #

![Что на картинке](image.png)

В page bundle — файл рядом с index.md. Alt не для SEO-спама, а для доступности и поломанных CDN.

Callout / замечания #

В чистом MD нет единого синтаксиса. Варианты:

> **Важно:** не включайте `-proposed` в unattended-upgrades.

Или shortcode темы/сайта, если нужен цветной блок.

Ловушки Goldmark / Hugo #

  1. Raw HTML может быть выключен — не стройте вёрстку на <div>.
  2. Таблица внутри списка — боль; вынесите таблицу отдельно.
  3. $$ math — только если math: true во front matter и настроен renderer.

Чеклист перед hugo #

  • нет H1 в body
  • code fence с языком
  • ссылки открываются
  • картинки с alt
  • front matter: summary ≠ description

Этого достаточно, чтобы текст выглядел «своим» на любом нормальном генераторе 🚀