Markdown
Разделительная черта
---
Заголовки
# Заголовок 1
или
Заголовок 1
===========
## Заголовок 2
или
Заголовок 2
-----------
### Заголовок 3
#### Заголовок 4
##### Заголовок 5
###### Заголовок 6
Работа с выделением текста
~~Зачеркнутый текст~~
~~Зачеркнутый текст (Strikethrough)~~
Для выделения текста жирным или наклонным и их сочетания можно использовать комбинации * или _
**Жирный текст (bold)**
Жирный текст (bold)
*Наклонный текст (italic)*
Наклонный текст (italic)
***Жирный наклонный текст (bold italic)***
Жирный наклонный текст (bold italic)
__Жирный текст (bold)__
Жирный текст (bold)
_Наклонный текст (italic)_
Наклонный текст (italic)
___Жирный наклонный текст (bold italic)___
Жирный наклонный текст (bold italic)
~~*__Тут странный текст__*~~
~~Тут странный текст~~
Использование эмодзи (emoji)
Для использования эмодзи в VS Code можно установить расширение Markdown Emoji
Можно использовать эмодзи:
:white_check_mark:
:negative_squared_cross_mark:
:black_square_button:
В оригинале это выглядит так (в конце строки четыре (2) пробела для того, что бы был переход на новую строку):
:white_check_mark:
:negative_squared_cross_mark:
:black_square_button:
Использование цитирования в тексте
> Цитата (уровень 1)
> > Вложенная цитата (уровень 2)
> > > Вложенная цитата (уровень 3)
> > Продолжение цитаты (уровень 2)
> Продолжение цитаты (уровень 1)
Цитата (уровень 1)
Вложенная цитата (уровень 2)
Вложенная цитата (уровень 3)
Продолжение цитаты (уровень 2)
Продолжение цитаты (уровень 1)
Внешний вид, конечно, не очень, но может и пригодиться.
Подсветка кода
Если нужно выделить слово или фразу внутри строки, то используются одинарные обратные кавычки (`):
Это `слово` будет выделено
Для выделения в блоки - тройные:
```
Здесь может быть
Ваша реклама
```
Дополнительно можно задавать язык кода внутри блока, указав его после первых трех кавычек:
```html
<input type="text">
```
```css
body {
margin: 0;
padding: 0;
}
```
```php
<?php phpinfo();?>
```
Пример блока для C#:
using System;
namespace Example
{
class Program
{
static void Main()
{
Console.WriteLine("Hello World!"); // Вывод заданного текста в консоль
Console.ReadKey(); // Ожидание нажатия клавиши пользователем
}
}
}
Пример блока для Python:
def factorial(n):
if n < 0:
raise ArithmeticError('Факториал отрицательного числа.')
f = 1
for i in range (2, n + 1):
f *= i
return f
print(factorial(10)) # 3628800
Списки
Маркированный
Задать маркированный список можно несколькими символами -, + или *:
- Уровень списка 1. Пункт 1.
- Уровень списка 1. Пункт 2.
- Уровень списка 1. Пункт 3.
- Уровень списка 1. Пункт 1.
- Уровень списка 1. Пункт 2.
- Уровень списка 1. Пункт 3.
+ Уровень списка 1. Пункт 1.
+ Уровень списка 1. Пункт 2.
+ Уровень списка 1. Пункт 3.
- Уровень списка 1. Пункт 1.
- Уровень списка 1. Пункт 2.
- Уровень списка 1. Пункт 3.
* Уровень списка 1. Пункт 1.
* Уровень списка 1. Пункт 2.
* Уровень списка 1. Пункт 3.
- Уровень списка 1. Пункт 1.
- Уровень списка 1. Пункт 2.
- Уровень списка 1. Пункт 3.
Можно создавать многоуровневые списки. Каждый уровень отделяется четырьмя (4) пробелами:
- Уровень списка 1. Пункт 1.
- Уровень списка 2. Пункт 1.
- Уровень списка 1. Пункт 2.
- Уровень списка 2. Пункт 1.
- Уровень списка 2. Пункт 2.
- Уровень списка 1. Пункт 3.
- Уровень списка 2. Пункт 1.
- Уровень списка 3. Пункт 1.
- Уровень списка 3. Пункт 2.
- Уровень списка 4. Пункт 1.
- Уровень списка 1. Пункт 1.
- Уровень списка 2. Пункт 1.
- Уровень списка 1. Пункт 2.
- Уровень списка 2. Пункт 1.
- Уровень списка 2. Пункт 2.
- Уровень списка 1. Пункт 3.
- Уровень списка 2. Пункт 1.
- Уровень списка 3. Пункт 1.
- Уровень списка 3. Пункт 2.
- Уровень списка 4. Пункт 1. Каждый уровень отделяется двумя пробелами или табуляцией.
- Уровень списка 2. Пункт 1.
Нумерованный
Для Githib работа с нумерованными списками выглядит очень интересно. Каждый уровень отделяется четырьмя (4) пробелами:
1. Первый уровень 1
1. Второй уровень 1
1. Третий уровень 1
1. Четвертый уровень 1
1. Пятый уровень 1
1. Шестой уровень
1. Седьмой уровень
1. Седьмой уровень
2. Первый уровень 2
2. Первый уровень (должно быть 3)
4. Первый уровень 4
- Первый уровень 1
- Второй уровень 1
- Третий уровень 1
- Четвертый уровень 1
- Пятый уровень 1
- Шестой уровень
- Седьмой уровень
- Седьмой уровень
- Седьмой уровень
- Шестой уровень
- Пятый уровень 1
- Четвертый уровень 1
- Третий уровень 1
- Второй уровень 1
- Первый уровень 2
- Первый уровень (должно быть 3)
- Первый уровень 4
Смешанные списки
При использовании смешанных списков нужно очень внимательно следить за нумерацией. Лучше, как и в нумерованных, использовать четыре (4) пробела для отделения уровня.
1. Первый уровень "нумерованный" - 1
* Второй уровень "маркер"
+ Третий уровень "маркер"
- Третий уровень "маркер"
1. Третий уровень "нумерованный" - 1
1. Четвертый уровень "нумерованный" - 1
1. Пятый уровень "нумерованный" - 1
1. Шестой уровень "нумерованный" - 1
1. Седьмой уровень "нумерованный" - 1
* Седьмой уровень "маркер"
2. Седьмой уровень "нумерованный" - 1 (нарушена нумерация, новая нумерация 1)
3. Седьмой уровень "нумерованный" - 1 (нарушена нумерация, новая нумерация 2)
1. Восьмой уровень "нумерованный" - 1
2. Первый уровень "нумерованный" - 2
- Первый уровень "нумерованный" - 3
4. Первый уровень "нумерованный" - 4 (нарушена нумерация, новая нумерация 1)
5. Первый уровень "нумерованный" - 5 (нарушена нумерация, новая нумерация 2)
- Первый уровень "нумерованный" - 1
- Второй уровень "маркер"
- Третий уровень "маркер"
- Третий уровень "маркер"
- Третий уровень "нумерованный" - 1
- Четвертый уровень "нумерованный" - 1
- Пятый уровень "нумерованный" - 1
- Шестой уровень "нумерованный" - 1
- Седьмой уровень "нумерованный" - 1
- Седьмой уровень "маркер"
- Седьмой уровень "нумерованный" - 1 (нарушена нумерация, новая нумерация 1)
- Седьмой уровень "нумерованный" - 1 (нарушена нумерация, новая нумерация 2)
- Восьмой уровень "нумерованный" - 1
- Шестой уровень "нумерованный" - 1
- Пятый уровень "нумерованный" - 1
- Четвертый уровень "нумерованный" - 1
- Второй уровень "маркер"
- Первый уровень "нумерованный" - 2
- Первый уровень "нумерованный" - 3
- Первый уровень "нумерованный" - 4 (нарушена нумерация, новая нумерация 1)
- Первый уровень "нумерованный" - 5 (нарушена нумерация, новая нумерация 2)
Список задач
(Task List) Можно создавать "Списки задач" для этого необходимо использовать - [ ] для поставленной задачи и - [X] для выполненной задачи.
Для использования эмодзи в VS Code можно установить расширение Markdown Task Lists
- [X] Придумать внешний вид резюме
- [ ] Написать основные категории
- [X] Опубликовать
- [X] Придумать внешний вид резюме
- [ ] Написать основные категории
- [X] Опубликовать
Также можно создавать многоуровневые списки задач. Каждый уровень отделяется четырьмя (4) пробелами:
- [X] Задача 1
- [X] Подзадача 1 для Задачи 1
- [X] Подзадача 2 для Задачи 1
- [ ] Задача 2
- [X] Подзадача 1 для Задачи 2
- [ ] Подзадача 2 для Задачи 2
- [ ] Задача 3
- [ ] Подзадача 1 для Задачи 3
- [ ] Подзадача 1 для Подзадача 1 для Задачи 3
- [X] Задача 1
- [X] Подзадача 1 для Задачи 1
- [X] Подзадача 2 для Задачи 1
- [ ] Задача 2
- [X] Подзадача 1 для Задачи 2
- [ ] Подзадача 2 для Задачи 2
- [ ] Задача 3
- [ ] Подзадача 1 для Задачи 3
- [ ] Подзадача 1 для Подзадача 1 для Задачи 3
- [ ] Подзадача 1 для Задачи 3
Ссылки
Либо просто вставить ссылку, либо дополнительно задать текст ссылки (пробела между скобками быть не должно):
Первый вариант вставки ссылок - это просто написать адрес сайта http://example.com
Первый вариант вставки ссылок - это просто написать адрес сайта http://example.com
Второй вариант записывается так: текст ссылки
[example.com](http://example.com)
Вставка изображения
Дополнительно:
Вставка ссылки с картинкой на ролик с YouTube
Описание комбинации [](ссылка на страничку YouTube)
Пример:
Вставка таблиц
| LEFT | CENTER | RIGHT |
|----------------|:---------:|----------------:|
| По левому краю | По центру | По правому краю |
| текст | текст | текст |
| LEFT | CENTER | RIGHT |
|---|---|---|
| По левому краю | По центру | По правому краю |
| текст | текст | текст |
Внимание: Если в тексте таблицы нужно использовать символ "вертикальная черта - |", то в место него необходимо написать замену на комбинацию HTML-кода |, это нужно для того, что бы таблица не потеряла ориентации. ) - Можно использовать ASCII и/или UTF коды.
Пример:
| Обозначение | Описание | Пример регулярного выражения|
|----:|:----:|:----------|
| literal | Строка содержит символьный литерал literal | foo |
| re1|re2 | Строка содержит регулярные выражения `rel` или `re2` | foo|bar |
Результат:
| Обозначение | Описание | Пример регулярного выражения |
|---|---|---|
| literal | Строка содержит символьный литерал literal | foo |
| re1|re2 | Строка содержит регулярные выражения re1 или re2 |
foo|bar |