Общая информация по языку Markdown.

1 Варианты языка Markdown

• Генератор статистических сайтов Hugo (см. Генератор статических сайтов Hugo) использует вариант Markdown на основе библиотеки Goldmark (см. Синтаксис markdown для генератора сайтов Hugo).

2 Базовый синтаксис Markdown

• Чтобы создать заголовок, используйте знак (#), например:

1# This is heading 1
2## This is heading 2
3### This is heading 3
4#### This is heading 4

This is heading 1

This is heading 2

This is heading 3

This is heading 4

• Чтобы задать для текста полужирное начертание, заключите его в двойные звездочки:

1This text is **bold**.

This text is bold.

• Чтобы задать для текста курсивное начертание, заключите его в одинарные звездочки:

1This text is *italic*.

This text is italic.

• Чтобы задать для текста полужирное и курсивное начертание, заключите его в тройные звездочки:

1This is text is both ***bold and italic***.

This is text is both bold and italic.

Блоки цитирования создаются с помощью символа >:

1> The drought had lasted now for ten million years, and the reign of the terrible lizards had long since ended. Here on the Equator, in the continent which would one day be known as Africa, the battle for existence had reached a new climax of ferocity, and the victor was not yet in sight. In this barren and desiccated land, only the small or the swift or the fierce could flourish, or even hope to survive.

Неупорядоченный (маркированный) список можно отформатировать с помощью звездочек или тире:

1- List item 1
2- List item 2
3- List item 3

Чтобы вложить один список в другой, добавьте отступ для элементов дочернего списка:

1- List item 1
2  - List item A
3  - List item B
4- List item 2

Упорядоченный список можно отформатировать с помощью соответствующих цифр:

11. First instruction
21. Second instruction
31. Third instruction

Чтобы вложить один список в другой, добавьте отступ для элементов дочернего списка:

11. First instruction
2   1. Sub-instruction
3   1. Sub-instruction
41. Second instruction

Синтаксис Markdown для встроенной ссылки состоит из части [link text], представляющей текст гиперссылки, и части (file-name.md) – URL-адреса или имени файла, на который дается ссылка:

1[link text](file-name.md)

Markdown поддерживает как встраивание фрагментов кода в предложение, так и их размещение между предложениями в виде отдельных огражденных блоков. Огражденные блоки кода — это простой способ выделить синтаксис для фрагментов кода. Общий формат огражденных блоков кода:

1``` language
2your code goes in here
3```

Верхние и нижние индексы: \[H_2\] записывается как

1H~2~O

\[2^{10}\] записывается как

12^10^

Внутритекстовые формулы делаются аналогично формулам LaTeX. Например, формула \(\sin^2 (x) + \cos^2 (x) = 1\) запишется как

1$\sin^2 (x) + \cos^2 (x) = 1$

Выключные формулы:

\[\sin^2 (x) + \cos^2 (x) = 1\] {#eq:eq:sin2+cos2} со ссылкой в тексте «Смотри формулу ([-@eq:eq:sin2+cos2]).» записывается как

1$$
2\sin^2 (x) + \cos^2 (x) = 1
3$$ {#eq:eq:sin2+cos2}
4
5Смотри формулу ([-@eq:eq:sin2+cos2]).

3 Специальные элементы

3.1 Видео Youtube

• Видео youtube нельзя добавить напрямую.
• В некоторых особых случаях можно добавлять непосредственно ссылку (например, в системе Moodle).
• Можно добавить изображение со ссылкой на видео в виде html:

  1<a href="http://www.youtube.com/watch?feature=player_embedded&v=YOUTUBE_VIDEO_ID_HERE" target="_blank">
  2  <img src="http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg" alt="alternative text for search engines" width="240" height="180" border="10" />
  3</a>
  

• Можно добавить изображение со ссылкой на видео в виде markdown (см. Миниатюры видео для youtube):

  1[![alternative text for search engines](http://img.youtube.com/vi/YOUTUBE_VIDEO_ID/0.jpg)](http://www.youtube.com/watch?v=YOUTUBE_VIDEO_ID)
  

3.2 Видео Rutube

• Идентификатор видео на Rutube представляет собой шестнадцатеричное число.

• В адресе для миниатюры используются первые цифры идентификатора.

• Изображение со ссылкой на видео в виде markdown:

  1[![alternative text for search engines](https://pic.rutubelist.ru/video/12/34/RUTUBE_PIC_ID.jpg)](https://rutube.ru/video/RUTUBE_VIDEO_ID/)
  

  • Здесь 12 — первые 2 цифры RUTUBE_PIC_ID; 34 — 3 и 4 цифры RUTUBE_PIC_ID.

• Связь RUTUBE_PIC_ID и RUTUBE_VIDEO_ID мне пока не понятна.