Markdown Syntax

В этой статье показаны основы синтаксиса Markdown для файлов контента Hugo, а также то, как типовые HTML-элементы оформляются CSS в теме Hugo.

Заголовки

Следующие элементы HTML <h1>—<h6> задают шесть уровней заголовков секций. <h1> — верхний уровень, <h6> — нижний.

H1

H2

H3

H4

H5
H6

Абзац

Markdown позволяет писать тексты в обычном виде и получать из них структурированный HTML: заголовки, списки, ссылки и выделения. Такой подход удобен для блогов и документации: исходник остаётся читаемым, а генератор сайта превращает его в валидную разметку. Для демонстрации ниже используются таблицы, цитаты и вложенные списки — всё это поддерживается Hugo и типовыми темами.

Второй абзац показывает, как отделяются блоки текста пустой строкой. Такое разбиение важно для Markdown: без пустой строки новый фрагмент может слиться с предыдущим при разборе.

Цитаты

Элемент blockquote задаёт текст, процитированный из другого источника; при желании добавляют атрибуцию через footer или cite, а также встроенные пояснения и сокращения.

Цитата без указания источника

Это пример цитаты без указания автора: текст может быть любым, главное — показать оформление. Обратите внимание: внутри цитаты можно использовать синтаксис Markdown.

Цитата с атрибуцией

Developers Developers Developers Developers

— Stive Balmer1

Таблицы

Таблицы не входят в базовую спецификацию Markdown, но в Hugo они поддерживаются из коробки.

ИмяВозраст
Bob27
Alice23

Markdown внутри ячеек таблицы

КурсивЖирныйКод
курсивжирныйcode

Типы списков

Нумерованный список

  1. Первый пункт
  2. Второй пункт
  3. Третий пункт

Маркированный список

  • Пункт списка
  • Ещё пункт
  • И ещё один

Вложенный маркированный список

  • Фрукты
    • Яблоко
    • Апельсин
    • Банан
  • Молочное
    • Молоко
    • Сыр

Вложенный нумерованный список

  1. Фрукты
    • Яблоко
    • Апельсин
    • Банан
  2. Молочное
    1. Молоко
    2. Сыр
  3. Третий пункт
    1. Подпункт один
    2. Подпункт два

Другие элементы — abbr, sub, sup, kbd, mark

GIF — растровый формат изображений.

H2O

Xn + Yn = Zn

Нажмите CTRL+ALT+Delete, чтобы завершить сеанс.

Большинство саламандр ведут ночной образ жизни и охотятся на насекомых, червей и других мелких существ.

  1. Цитата взята из выступления Stive Balber. ↩︎