84 lines
2.8 KiB
Markdown
84 lines
2.8 KiB
Markdown
|
# 06 — Основы Markdown
|
||
|
|
|
||
|
|
🌍 [English](../../en/06-markdown-basics/readme.md) · [Türkçe](../../tr/06-markdown-basics/readme.md) · [Deutsch](../../de/06-markdown-basics/readme.md) · [Français](../../fr/06-markdown-basics/readme.md) · **Русский**
|
||
|
|
|
||
|
|
Markdown — это обычный текст с несколькими правилами пунктуации. Файлы с расширением `.md` отображаются автоматически, а файл с именем `readme.md` показывается на странице своего каталога.
|
||
|
|
|
||
|
|
## Заголовки
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
# Заголовок
|
||
|
|
## Раздел
|
||
|
|
### Подраздел
|
||
|
|
```
|
||
|
|
|
||
|
|
Оставляйте пустую строку до и после заголовка.
|
||
|
|
|
||
|
|
## Текст
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
**жирный** *курсив* ~~зачёркнутый~~ `код`
|
||
|
|
```
|
||
|
|
|
||
|
|
Одиночный перенос строки игнорируется. Чтобы начать новый абзац, оставьте пустую строку.
|
||
|
|
|
||
|
|
## Списки
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
- первый
|
||
|
|
- второй
|
||
|
|
- вложенный (два пробела)
|
||
|
|
|
||
|
|
1. шаг один
|
||
|
|
2. шаг два
|
||
|
|
```
|
||
|
|
|
||
|
|
## Ссылки
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
[KabaForge](https://forge.kabaforce.com)
|
||
|
|
[глава 04](../04-create-directory/readme.md)
|
||
|
|
```
|
||
|
|
|
||
|
|
Ссылки на файлы того же репозитория лучше писать относительными путями — они продолжают работать в любой ветке.
|
||
|
|
|
||
|
|
## Код
|
||
|
|
|
||
|
|
Блоки в «заборчиках» сохраняют отступы и добавляют подсветку. Язык пишется сразу после открывающего заборчика:
|
||
|
|
|
||
|
|
~~~markdown
|
||
|
|
```bash
|
||
|
|
git status
|
||
|
|
```
|
||
|
|
~~~
|
||
|
|
|
||
|
|
## Таблицы
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
| Столбец | Значение |
|
||
|
|
|---------|----------|
|
||
|
|
| `main` | ветка по умолчанию |
|
||
|
|
| `.md` | файл Markdown |
|
||
|
|
```
|
||
|
|
|
||
|
|
## Цитаты, линии, задачи
|
||
|
|
|
||
|
|
```markdown
|
||
|
|
> Цитируемая заметка.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
- [x] сделано
|
||
|
|
- [ ] ещё не сделано
|
||
|
|
```
|
||
|
|
|
||
|
|
## Практические советы
|
||
|
|
|
||
|
|
- Смотрите предпросмотр до коммита: вкладка **Предпросмотр** в редакторе показывает ровно то, что увидят другие.
|
||
|
|
- В длинных документах пишите по одному предложению на строку — различия между версиями остаются читаемыми.
|
||
|
|
- Эмодзи работают напрямую: 📌 ✅ ⚠️
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
⬅ [Назад: 05 — Удаление файлов и каталогов](../05-delete-files/readme.md) · 📚 [Содержание](../README.md) · [Далее: 07 — Изображения и вложения](../07-images-and-media/readme.md) ➡
|