Учебник VuePress

# Строки, списки и блоки текста Markdown

У Markdown есть широкий охват «блоков» текста, таких как списки, блочные кавычки и горизонтальные правила.

# Markdown обычно обрабатывает несколько пустых строк как одну

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

Markdown:

Строка 1

Линия 3?



Строка 7?
1
2
3
4
5
6
7

Результат:

Строка 1

Линия 3?

Строка 7?

# Markdown: две соседние строки текста

Как и HTML, Markdown считает конец строки текста эквивалентным пробелу. Давайте взглянем.

Markdown:

кто нашел тебя в зеленом лесу
и тебе было очень жаль уходить?
1
2

Результат:

кто нашел тебя в зеленом лесу и тебе было очень жаль уходить?

Это оказывается очень полезным, когда вы пишете большое количество документации с использованием таких инструментов, как VuePress. Отчасти потому, что так или иначе ведет себя HTML, а также потому, что это помогает инструментам «заливать» текст в абзацы, которые корректируются в соответствии с размером экрана.

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

Теперь предположим, что вы блестящий поэт и хотите, чтобы ваши строки были разделены определенным образом? Ключ должен заканчивать каждую строку двумя пробелами. Здесь они представлены точками.

Markdown:

ПРИМЕЧАНИЕ. В этом примере `⋅` «точка» обозначает символ пробела⋅⋅

кто нашел тебя в зеленом лесу⋅⋅
и вам было очень жаль уходить?
1
2
3
4

Результат:

кто нашел тебя в зеленом лесу
и вам было очень жаль уходить?

# Списки markdown

HTML (и, следовательно, Markdown) распознает два вида списков: неупорядоченные (маркированные списки), и упорядочены (нумерованные списки).

# Markdown синтаксиса неупорядоченного списка

Элементы неупорядоченного списка начинают строку со звездочки и пробела (*):

Markdown:

* Попробуйте перезагрузиться.
* В случае, если это не сработает, разбейте его молотком.
1
2

Результат:

  • Попробуйте перезагрузиться.
  • В случае, если это не сработает, разбейте его молотком.

# Синтаксис альтернативного неупорядоченного списка

Вы также можете использовать + или - вместе с * для создания неупорядоченного списка:

Варианты уценки для неупорядоченных списков:

* звездочка
+ знак плюс
- знак минус
1
2
3

Результат:

  • звездочка
  • знак плюс
  • знак минус

# Markdown синтаксиса упорядоченного списка

Упорядоченные элементы списка начинают строку с числа, точки и пробела (1.):

Markdown:

1. Эдди Ван Хален
1. Джон Майер
1
2

Результат:

  1. Эдди Ван Хален
  2. Джон Майер

# Синтаксис отступа списка отступов: вложенные списки

Вы можете вкладывать списки, делая отступы с двумя пробелами на уровень.

Markdown:

ПРИМЕЧАНИЕ: в этом примере `⋅` точка represents представляет символ пробела

* Первый уровень идентификации

⋅⋅* Второй уровень отступа
⋅⋅* Подробнее о втором уровне
⋅⋅* Смотри, ма, 3 предмета!

⋅⋅⋅⋅* Третий уровень отступа?
⋅⋅⋅⋅* Только два предмета, чтобы увидеть здесь

⋅⋅⋅⋅⋅⋅* Четвертый уровень?
⋅⋅⋅⋅⋅⋅* Не уверен, насколько глубокие списки могут быть вложенными
* Возврат к списку первого уровня
1
2
3
4
5
6
7
8
9
10
11
12
13
14

Результат:

  • Первый уровень идентификации

    • Второй уровень отступа

    • Подробнее о втором уровне

    • Смотри ма, 3 предмета!

      • Третий уровень отступа?

      • Здесь можно увидеть только два предмета

        • Четвертый уровень?
        • Не уверен, насколько глубокие списки могут быть вложенными

  • Возврат к списку первого уровня

Тестирование 2 строки:

Линия 1 с двумя пробелами в конце
Линия 2

Линия 1 без пробелов в конце Линия 2

# Отступ текста

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

Markdown:

1. Эдди Ван Хален

   Кто-то скажет, что он не самый лучший. Но они неполноценные люди.
1. Джон Майер
1
2
3
4

Результат:

  1. Эдди Ван Хален

    Кто-то скажет, что он не самый лучший. Но они неполноценные люди.

  2. Джон Майер

# Блокировать кавычки - block quote

Чтобы выделить достаточно большой фрагмент текста, вы можете предпочесть использовать синтаксис block quote, который просто начинает строку с символа больше (>):

Markdown:


Как сказал великий Тони Старк:

> Я большой поклонник того, как ты теряешь контроль и превращаешься в огромного зеленого ярого монстра.
1
2
3
4

Результат:

Как сказал великий Тони Старк:

Я большой поклонник того, как ты теряешь контроль и превращаешься в огромного зеленого ярого монстра.

Несколько символов > в последовательных строках работают вместе как один:

Markdown:


Как сказал великий Тони Старк:

> Я большой поклонник того, как ты теряешь контроль
> И превратиться в огромного зеленого ярого монстра.
1
2
3
4
5

Результат:

Как сказал великий Тони Старк:

Я большой поклонник того, как ты теряешь контроль И превратиться в огромного зеленого ярого монстра.

← Пользовательские блоки →