Руководство для начинающих по Markdown

Markdown — это простой язык, созданный для упрощения написания контента. Его используют повсюду: от GitHub до приложений для заметок. Если вы писатель, разработчик или просто человек, желающий упростить свою письменность в сети, это руководство для вас!

Что такое Markdown?

Markdown — это легкий язык разметки, созданный Джоном Грубером в 2004 году, чтобы сделать форматированный текст легко читаемым в простых текстовых редакторах. Он особенно популярен для блогов, мгновенных сообщений, форумов, совместных инструментов, документации и файлов readme. С течением времени различные интерпретации привели к созданию CommonMark в 2014 году, более ясной спецификации с набором тестов для обеспечения последовательной реализации.

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

Вот краткое описание наиболее распространенных элементов, которые вам понадобятся:

1. Заголовки

Заголовки создаются с использованием символа #, за которым следует пробел:

# Это H1 
## Это H2 
### Это H3

2. Акценты

Для курсива используйте *звездочки* или _нижние подчеркивания_.

Для жирного используйте **две звездочки** или __два нижних подчеркивания__.

3. Списки

Неупорядоченные списки

Используйте звездочки, плюсы или минусы, за которыми следует пробел:

* Элемент 1 
* Элемент 2   
    * Подэлемент 2.1   
    * Подэлемент 2.2

Упорядоченные списки

Просто используйте номера, за которыми следуют точки:

1. Первый элемент 
2. Второй элемент 
3. Третий элемент

4. Ссылки

Вы можете создать встроенную ссылку с использованием следующего синтаксиса:

[Отображаемый текст](URL "Необязательный заголовок")

5. Изображения

Изображения аналогичны ссылкам, но с восклицательным знаком перед ними:

![Альтернативный текст](URL "Необязательный заголовок")

6. Цитаты

Для цитат используйте символ > перед вашим текстом:

> Это цитата.

7. Блоки кода

Для кода в строке заключите ваш код в обратные кавычки:

`код здесь`

Для блоков кода из нескольких строк используйте три обратные кавычки:

\```
Строка 1 кода
Строка 2 кода
Строка 3 кода
\```

8. Горизонтальная линия

Вы можете создать горизонтальную линию с использованием трех тире, звездочек или подчеркиваний:

---

Другие полезные элементы

Таблицы:

| Заголовок1 | Заголовок2 | 
|-----------|-----------| 
| ячейка1   | ячейка2   | 
| ячейка3   | ячейка4   |

Списки задач:

- [x] Завершенная задача 
- [ ] Незавершенная задача

Зачеркнутый:

Используйте ~~ для зачеркнутого текста:

~~зачеркнуто~~

Написание цитат в Markdown:

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

Согласно недавним исследованиям [@Smith2023], эффект...

Вы также можете использовать несколько цитат:

Некоторые ученые утверждают эту точку зрения [@Smith2023; @Doe2022].

Косвенные и прямые цитаты:

Косвенные (или в тексте) ставят автора и дату в скобки:

Как указывалось [@Smith2023], ...

Прямые цитаты также включают номера страниц:

[@Smith2023, pp. 33-35] утверждает, что ...

Закончим быстрым введением в то, как добавить видео в ваш файл Markdown.

Вставка видео:

Для вставки видео с платформы, такой как YouTube, вам, как правило, понадобится использовать код вставки, предоставленный этой платформой.

<iframe width="560" height="315" src="https://www.youtube.com/embed/VIDEO_ID" frameborder="0" allowfullscreen></iframe>

Замените “VIDEO_ID” на конкретный идентификатор видео, который вы хотите вставить. Имейте в виду, что точный способ вставки видео может зависеть от платформы и хоста вашего сайта.