Нотация Markdown в Hugo

В этом разделе показано, как писать рукописи в формате Markdown в Hugo.

Базовый Markdown

Для получения дополнительной информации о том, как писать в формате Markdown, смотрите Hugo — Руководство по Markdown.

Назначение классов CSS элементам, написанным в Markdown

Для получения дополнительной информации смотрите attribute в Goldmark — Hugo. Ниже приведен обзор.

1. Поместите следующее в /config.toml.

   [markup.goldmark.parser.attribute]
   block = true
   

2. Пишите имена классов, такие как {.classA .classB} на следующей строке блочного элемента, написанного в Markdown в исходном документе.

   * Fruit
     * Apple
     * Orange
     * Banana
     {.fruits}
   * Dairy
     * Milk
     * Cheese
     {.dairies}
   {.list}
   

Писать HTML напрямую вместо Markdown

Для получения дополнительной информации смотрите unsafe в Goldmark — Hugo. Обзор приведен ниже.

1. Поместите следующее в /config.toml.

   [markup.goldmark.renderer]
   unsafe = true
   

2. Напишите HTML для рукописи.

   * Fruit            ← I can write Markdowns and ...
   * Dairy
   {.list}
   
   <ul class="list">  ← I can write HTML too.
     <li>Fruit</li>
     <li>Dairy</li>
   </ul>
   

Написание с помощью шорткодов

Шорткоды — это предварительно созданные HTML-сниппеты Hugo и различных тем.
Они включают в себя вставку видео и статей Instagram/Twitter, которые трудно выразить только с помощью Markdown, и генерацию ссылок из путей рукописи, требующих серверной обработки. Подробности смотрите ниже.