# Руководство по оформлению Markdown файлов Markdown - это облегчённый язык разметки, который преобразует текст в структурированный HTML. Следующее руководство поможет вам разобраться, как использовать Markdown. ## Заголовки ``` # Заголовок первого уровня ## Заголовок второго уровня ### Заголовок третьего уровня #### Заголовок четвёртого уровня ##### Заголовок пятого уровня ###### Заголовок шестого уровня ``` ***Пример:*** # Заголовок первого уровня ## Заголовок второго уровня ### Заголовок третьего уровня #### Заголовок четвёртого уровня ##### Заголовок пятого уровня ###### Заголовок шестого уровня --- ## Параграфы и переносы строк ``` Это параграф. Чтобы создать новый параграф, оставьте пустую строку между двумя строками текста. Это первая строка И это вторая строка, но они находятся в одном параграфе. Для переноса строки используйте два пробела в конце предыдущей строки. ``` ***Пример:*** Это параграф. Чтобы создать новый параграф, оставьте пустую строку между двумя строками текста. Это первая строка И это вторая строка, но они находятся в одном параграфе. Для переноса строки используйте два пробела в конце предыдущей строки. --- ## Выделение текста ``` *курсив* _курсив_ **жирный** __жирный__ ***жирный курсив*** ___жирный курсив___ ~~зачеркнутый~~ ``` ***Пример:*** *курсив* _курсив_ **жирный** __жирный__ ***жирный курсив*** ___жирный курсив___ ~~зачеркнутый~~ --- ## Списки ### Нумерованный список ``` 1. Пункт первый 2. Пункт второй 3. Пункт третий ``` ***Пример:*** 1. Пункт первый 2. Пункт второй 3. Пункт третий --- ### Маркированный список ``` - Пункт первый - Пункт второй - Пункт третий ``` ***Пример:*** - Пункт первый - Пункт второй - Пункт третий --- ### Вложенные списки Также можно делать вложенные списки, добавляя 4 пробела перед пунктом: ``` 1. Пункт первый - Подпункт первый - Подпункт второй 2. Пункт второй ``` ***Пример:*** 1. Пункт первый - Подпункт первый - Подпункт второй 2. Пункт второй --- ## Ссылки ``` [Текст ссылки](https://www.example.com) ``` ***Пример:*** [Текст ссылки](https://www.example.com) --- ## Изображения ``` ![Текст описания](https://www.example.com/image.jpg) ``` ***Пример:*** ![Текст описания](https://assets.simpleviewinc.com/simpleview/image/upload/c_fill,h_720,q_75,w_1400/v1/clients/newyorkcity/Coronavirus_Info_midtown_manhattan_skyline_nyc_3000x2000_364fa9b8-86ce-4f95-907a-4bd8ea32f232.jpg) --- ## Блоки кода ### Строка кода ``` `строка кода` ``` ***Пример:*** `строка кода` --- ### Блок кода Удалите символы `\` ``` \``` Блок кода \``` ``` ***Пример:*** ``` Блок кода ``` --- ### Подсветка кода Для блоков кода можно указывать язык программирования. Используется подсветка синтаксиса из библиотеки `linguist`, которая включает множество различных языков. Удалите символы `\` ``` \```python print("Привет, мир!") \``` ``` ***Пример:*** ```python print("Привет, мир!") ``` --- ## Цитаты ``` > Первый уровень цитирования >> Второй уровень цитирования >>> Третий уровень цитирования ``` ***Пример:*** > Первый уровень цитирования >> Второй уровень цитирования >>> Третий уровень цитирования --- ## Горизонтальная линия ``` --- ``` ***Пример:*** --- --- ## Таблицы ``` | Заголовок 1 | Заголовок 2 | | ----------- | ----------- | | Ячейка 1 | Ячейка 2 | | Ячейка 3 | Ячейка 4 | ``` ***Пример:*** | Заголовок 1 | Заголовок 2 | | ----------- | ----------- | | Ячейка 1 | Ячейка 2 | | Ячейка 3 | Ячейка 4 | --- ### Таблица как HTML ```
Заголовок 1 Заголовок 2
Ячейка 1.1 Ячейка 2.1
Ячейка 1.2 Ячейка 2.2
``` ***Пример:***
Заголовок 1 Заголовок 2
Ячейка 1.1 Ячейка 2.1
Ячейка 1.2 Ячейка 2.2
--- ## Чек-листы ``` - [x] Задача 1 - [ ] Задача 2 - [ ] Задача 3 ``` ***Пример:*** - [x] Задача 1 - [ ] Задача 2 - [ ] Задача 3 --- ## Внутренние ссылки ``` [Перейти к Заголовку 1](#title1) ## Заголовок 1 Какой-то контент ``` ***Пример:*** [Перейти к Заголовку 1](#title1) ## Заголовок 1 Какой-то контент --- ### Ссылка на заголовок на английском ``` [Some title 1](#some-title-1) ## Some Title 1 Some content ``` ***Пример:*** [Some title 1](#some-title-1) ## Some Title 1 Some content --- ## Автоматические ссылки ``` ``` ***Пример*** --- ## HTML Markdown поддерживает использование прямого HTML внутри документа, так что вы можете использовать любые HTML-теги для более сложного оформления: ``` CTRL + P ``` ***Пример:*** CTRL + P --- ## HTML-коды Например, вы можете использовать HTML-код `¯` для добавления черты над буквой: ``` A¯ ``` ***Пример:*** A¯ --- ## Комментарии Вы можете вставить комментарии в свой markdown-файл, которые не будут отображаться в окончательном отформатированном виде: ``` [//]: # (Это комментарий, он не будет отображаться) ``` ***Пример:*** [//]: # (Это комментарий, он не будет отображаться) --- ## Эмодзи (Github) Вы можете использовать эмодзи в своих Markdown-файлах. [Существует множество эмодзи](https://gist.github.com/rxaviers/7360908), которые вы можете использовать, вот некоторые из них: ``` :smile: :laughing: :blush: ``` ***Пример:*** :smile: :laughing: :blush: ---