Прежде чем мы начнем разработку нашего нового замечательного сайта, необходимо узнать что такое Markdown.
Markdown - это язык, используемый для написания контента. Контент может быть любым, например, сообщения в блогах, рецепты блюд, книги, документация и так далее. Затем Markdown преобразуется в код, подобный HTML, который может быть понят браузерами. Браузеры в свою очередь смогут отобразить его на экране.
Он очень прост в изучении и он позволяет нам последовательно и легко форматировать наш контент. Это означает, что все заголовки и субтитры будут выглядеть одинаково, все цитаты и абзацы будут выглядеть одинаково, и все списки также будут выглядеть одинаково.
Sandbox
Чтобы поэкспериментировать со всем, что мы узнаем на этой странице, используй песочницу (sandbox) ниже. Напиши код слева и посмотри на результат, который песочница выдает справа.
Заголовки (Headers)
Для создания заголовков разного размера доступно 6 вариантов.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Чем меньше число, тем крупнее текст.
Попробуй скопировать и вставить этот фрагмент в песочницу и посмотреть, как это работает.
Курсив (Italics)
Чтобы выделить текст курсивом, ты можешь заключить слово в подчеркивание.
Привет _Лера_!
Результат приведенного выше фрагмента будет выглядеть так –> Привет Лера!
Полужирный (Bold)
Чтобы выделить текст жирным шрифтом, заключи слово в двойные звездочки.
Я - **полужирный шрифт**
Результат –> Я - полужирный шрифт
Списки (Lists)
Существует два типа списков, которые можно форматировать с помощью Markdown: упорядоченный и неупорядоченный.
Упорядоченный (Ordered)
Для создания упорядоченных списков просто напиши число с точкой после, а затем текст:
1. Прости
2. Прощай
3. Привет
Результат:
- Прости
- Прощай
- Привет
Неупорядоченный (Unordered)
Для списков, в которых используются маркеры, используй тире перед элементом:
- Прости
- Прощай
- Привет
Результат:
- Прости
- Прощай
- Привет
Зачеркивание (Scratch)
Чтобы что-то вычеркнуть, используй двойные тильды.
- Яйца
- ~~Молоко~~
Результат:
- Яйца
Молоко
Ссылки (Links)
Чтобы создать ссылку на другую страницу, используй квадратные скобки для текста, а затем скобки для ссылки.
[Нажми на меня](https://google.com)
Output:
Изображения (Images)
Изображения принимают URL-адрес, альтернативный текст и заголовок. URL-адрес предназначен для загрузки изображения, а альтернативный текст - это текст, который должен отображаться, если изображение не может быть загружено должным образом. Текст заголовка предназначен для того, чтобы отображалась небольшая всплывающая подсказка, когда кто-то наводит курсор мыши на изображение.
![alt text](https://hugo-mini-course.netlify.app/img/yellowduck.png "Logo Title Text 1")
Результат:
Таблицы (Tables)
Мы также можем легко создавать красивые таблицы в Markdown, используя контуры и тире.
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
Результат:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
Цитаты (Blockquotes)
Иногда нам хочется процитировать фразу, это можно сделать с помощью символа >
.
> Я мыслю, следовательно, я существую.
Результат:
Я мыслю, следовательно, я существую.
Дополнительная информация
Эта информация в значительной степени покрывает 95% того, что тебе нужно знать о Markdown, но для получения дополнительной информации ознакомься с этой шпаргалкой на Github.
**Забавный факт: Весь этот мини-курс по Hugo сделан с помощью Hugo и с помощью Markdown!