Markdown как перенести на новую строку

fomvasss / Шпаргалка по Markdown.md

Поиграть с разметкой Markdown можно на демо-странице.

# H1 ## H2 ### H3 #### H4 ##### H5 ###### H6 Кроме того, H1 и H2 можно обозначить подчеркиванием: Alt-H1 ====== Alt-H2 ------ 

Кроме того, заголовки H1 и H2 можно обозначить подчеркиванием:

Курсив обозначается *звездочками* или _подчеркиванием_. Полужирный шрифт - двойными **звездочками** или __подчеркиванием__. Комбинированное выделение **звездочками и _подчеркиванием_**. Для зачеркнутого текста используются две тильды . ~~Уберите это.~~ 

Курсив обозначается звездочками или подчеркиванием.

Полужирный шрифт — двойными звездочками или подчеркиванием.

Комбинированное выделение звездочками и подчеркиванием.

Для зачеркнутого текста используются две тильды . Уберите это.

(В данном примере предшествующие и завершающие пробелы обозначены точками: ⋅)

1. Первый пункт нумерованного списка 2. Второй пункт ⋅⋅*Ненумерованный вложенный список. 1. Сами числа не имеют значения, лишь бы это были цифры ⋅⋅1. Нумерованный вложенный список 4. И еще один пункт. ⋅⋅⋅Внутри пунктов списка можно вставить абзацы с таким же отступом. Обратите внимание на пустую строку выше и на пробелы в начале (нужен по меньшей мере один, но здесь мы добавили три, чтобы также выровнять необработанный Markdown). ⋅⋅⋅Чтобы вставить разрыв строки, но не начинать новый параграф, нужно добавить два пробела перед новой строкой.⋅⋅ ⋅⋅⋅Этот текст начинается с новой строки, но находится в том же абзаце.⋅⋅ ⋅⋅⋅(В некоторых обработчиках, например на Github, пробелы в начале новой строки не нужны.) * Ненумерованный список можно размечать звездочками - Или минусами + Или плюсами 

1. Первый пункт нумерованного списка
2. Второй пункт

• Ненумерованный вложенный список.

1. Сами числа не имеют значения, лишь бы это были цифры
2. Нумерованный вложенный список
3. И еще один пункт. Внутри пунктов списка можно вставить абзацы с таким же отступом. Обратите внимание на пустую строку выше и на пробелы в начале (нужен по меньшей мере один, но здесь мы добавили три, чтобы также выровнять необработанный Markdown). Чтобы вставить разрыв строки, но не начинать новый параграф, нужно добавить два пробела перед новой строкой. Эта текст начинается с новой строки, но находится в том же абзаце. (В некоторых обработчиках, например на Github, пробелы в начале новой строки не нужны.)

• Ненумерованный список можно размечать звездочками

• Или минусами

• Или плюсами

Ссылки можно оформить разными способами.

[Обычная ссылка в строке](https://www.google.com) [Обычная ссылка с title](https://www.google.com "Сайт Google") [Ссылка со сноской][Произвольный регистронезависимый текст] [Относительная ссылка на документ](../blob/master/LICENSE) [Для ссылок со сноской можно использовать цифры][1] Или можно просто вставить ссылку в квадратные скобки [текст ссылки] Произвольный текст, после которого можно привести ссылки. [произвольный регистронезависимый текст]: https://www.mozilla.org [1]: http://slashdot.org [текст ссылки]: http://www.reddit.com 

Или можно просто вставить ссылку в квадратные скобки текст ссылки

Произвольный текст, после которого можно привести ссылки.

(*) Для символов не входящих в ASCII, например кириллицы, текст сноски все-таки регистрозависим (прим. перев.)

Вот наш логотип (наведите указатель, чтобы увидеть текст заголовка): Внутри строки: ![alt-текст](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Текст заголовка логотипа 1") В сноске: ![alt-текст][logo] [logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Текст заголовка логотипа 2" 

Вот наш логотип (наведите указатель, чтобы увидеть текст заголовка):

Внутри строки:

В сноске:

Код и подсветка синтаксиса

Блоки кода являются частью функций Markdown, но не подсветка синтаксиса. Однако многие обработчики, например Github или Markdown Here, поддерживают подсветку синтаксиса. Список поддерживаемых языков и способ их указания может различаться. Markdown Here поддерживает десятки языков (и не-языков, например синтаксис diff и заголовки HTTP); полный список и способ указания языков см. на странице highlight.js demo-странице.

`Код` в строке обрамляется `обратными апострофами`. 

Код в строке обрамляется обратными апострофами .

Блоки кода выделяются либо тремя обратными апострофами «` либо четырьмя пробелами в каждой строке. Рекомендуется использовать три апострофа — они проще и только они поддерживают подсветку синтаксиса.

```javascript var s = "Подсветка JavaScript"; alert(s); ``` ```python s = "Подсветка Python" print s ``` ``` Язык не указан, синтаксис не подсвечен. Но мы вставим в него тег. ``` 

var s = "Подсветка JavaScript"; alert(s);

s = "Подсветка Python" print s

Язык не указан, синтаксис не подсвечен (некоторые обработчики все же подсвечивают). Но мы вставим в него тег. 

Таблицы не являются частью Markdown, но многие обработчики, например Markdown Here и Github, поддерживают их. Они позволяют легко добавить таблицы в электронное письмо — в других случаях для этого нужно копировать их из другого приложения.

Вертикальные линии обозначают столбцы. | Таблицы | Это | Круто | | ------------- |:------------------:| -----:| | столбец 3 | выровнен вправо | $1600 | | столбец 2 | выровнен по центру | $12 | | зебра-строки | прикольные | $1 | Внешние вертикальные линии (|) не обязательны, и они нужны только чтобы сам код Markdown выглядел красиво. Тот же код можно записать так: Markdown | не такой | красивый --- | --- | --- *Но выводится* | `так же` | **клево** 1 | 2 | 3 

Вертикальные линии обозначают столбцы.

Таблицы	Это	Круто
столбец 3	выровнен вправо	$1600
столбец 2	выровнен по центру	$12
зебра-строки	прикольные	$1

Внешние вертикальные линии (|) не обязательны, и они нужны только чтобы сам код Markdown выглядел красиво. Тот же код можно записать так:

Markdown	не такой	красивый
Но выводится	так же	клево
1	2	3

> С помощью цитат очень удобно в письме обозначать исходный текст. > Эта строка - часть той же цитаты. Разрыв цитаты. > Это очень длинная строка, но она будет правильно процитирована даже при размещении на нескольких строках. Продолжаем писать, чтобы эта строка не вмещалась на одной строке в любом окне. Кстати, в цитаты можно *вставлять* даже **Markdown**. 

С помощью цитат очень удобно в письме обозначать исходный текст. Эта строка — часть той же цитаты.

Это очень длинная строка, но она будет правильно процитирована даже при размещении на нескольких строках. Продолжаем писать, чтобы эта строка не вмещалась на одной строке в любом окне. Кстати, в цитаты можно также размечать с помощью Markdown.

Часто Markdown понимает чистый HTML.

 
Список определений
 
Это то, что люди иногда используют.
 
Markdown внутри HTML
 
Работает *не очень** хорошо. Используйте HTML-теги.
 
 

Список определений Это то, что люди иногда используют. Markdown внутри HTML Работает *не очень** хорошо. Используйте HTML-теги.

Три и более. --- Дефисы *** Звездочки ___ Подчеркивания 

Краткое руководство по Маркдауну

Официальное руководство по синтаксису Markdown мне кажется слишком длинным и не слишком наглядным, поэтому я составил краткое руководство, которое поможет выучить или повторить синтаксис Маркдауна за час.

Кроме традиционного Маркдауна у разработчиков получил распространение дополненный и улучшеный вариант языка — Github Flavoured Markdown, сокращенно GFM.

Основные отличия GFM и чистого Маркдауна:

• добавили таблицы, которых не было в оригинальном Маркдауне;
• добавили альтернативный синтаксис для вставки блоков кода: теперь можно не ставить 4 пробела перед каждой строкой кода, также можно явно указать язык кода;
• добавили зачеркнутый текст.

 # GitHub-Flavored Markdown ## Краткое руководство Абзацы создаются при помощи пустой строки. Если вокруг текста сверху и снизу есть пустые строки, то текст превращается в абзац. Чтобы сделать перенос строки вместо абзаца, нужно поставить два пробела в конце предыдущей строки. Заголовки отмечаются диезом `#` в начале строки, от одного до шести. Например: # Заголовок первого уровня # ## Заголовок h2 ### Заголовок h3 #### Заголовок h4 ##### Заголовок h5 ###### Заголовок h6 В декоративных целях заголовки можно «закрывать» с обратной стороны. ### Списки Для разметки неупорядоченных списков можно использовать или `*`, или `-`, или `+`: - элемент 1 - элемент 2 - элемент . Вложенные пункты создаются четырьмя пробелами перед маркером пункта: * элемент 1 * элемент 2 * вложенный элемент 2.1 * вложенный элемент 2.2 * элемент . Упорядоченный список: 1. элемент 1 2. элемент 2 1. вложенный 2. вложенный 3. элемент 3 4. Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing. На самом деле не важно как в коде пронумерованы пункты, главное, чтобы перед элементом списка стояла цифра (любая) с точкой. Можно сделать и так: 0. элемент 1 0. элемент 2 0. элемент 3 0. элемент 4 Список с абзацами: * Раз абзац. Lorem ipsum dolor sit amet, consectetur adipisicing elit. * Два абзац. Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing. * Три абзац. Ea, quis, alias nobis porro quos laborum minus sed fuga odio dolore natus quas cum enim necessitatibus magni provident non saepe sequi? Четыре абзац (Четыре пробела в начале или один tab). ### Цитаты Цитаты оформляются как в емейлах, с помощью символа `>`. > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, > consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. > Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse > id sem consectetuer libero luctus adipiscing. Или более ленивым способом, когда знак `>` ставится перед каждым элементом цитаты, будь то абзац, заголовок или пустая строка: > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing. В цитаты можно помещать всё что угодно, в том числе вложенные цитаты: > ## This is a header. > > 1. This is the first list item. > 2. This is the second list item. > > > Вложенная цитата. > > Here's some example code: > > return shell_exec("echo $input | $markdown_script"); ### Исходный код В чистом Маркдауне блоки кода отбиваются 4 пробелами в начале каждой строки. Но в GitHub-Flavored Markdown (сокращенно GFM) есть более удобный способ: ставим по три апострофа (на букве Ё) до и после кода. Также можно указать язык исходного кода. ` ` `html nav class="nav nav-primary"> ul>   0 комментариев Комментарии       Войти     ul> nav> ` ` ` Самое приятное, что в коде не нужно заменять угловые скобки `< >` и амперсанд `&` на их html-сущности. ### Инлайн код Для вставки кода внутри предложений нужно заключать этот код в апострофы (на букве Ё). Пример: ``. Если внутри кода есть апостроф, то код надо обрамить двойными апострофами: ``There is a literal backtick (`) here.`` ### Горизонтальная черта `hr` создается тремя звездочками или тремя дефисами. *** ### Ссылки Это встроенная [ссылка с title элементом](http://example.com/link "Я ссылка"). Это — [без title](http://example.com/link). А вот [пример][1] [нескольких][2] [ссылок][id] с разметкой как у сносок. Прокатит и [короткая запись][ ] без указания id. [1]: http://example.com/ "Optional Title Here" [2]: http://example.com/some [id]: http://example.com/links (Optional Title Here) [короткая запись]: http://example.com/short Вынос длинных урлов из предложения способствует сохранению читабельности исходника. Сноски можно располагать в любом месте документа. ### Emphasis Выделять слова можно при помощи `*` и `_`. Одним символ для наклонного текста, два символа для жирного текста, три — для наклонного и жирного одновременно. Например, это _italic_ и это тоже *italic*. А вот так уже __strong__, и так тоже **strong**. А так ***жирный и наклонный*** одновременно. ### Зачеркивание В GFM добавлено зачеркивание текста: две тильды `~` до и после текста. ~~Зачеркнуто~~ ## Картинки Картинка без `alt` текста ![](http://placehold.it/150x100) Картинка с альтом и тайтлом: ![Alt text](http://placehold.it/150x100 "Можно задать title") Запомнить просто: синтаксис как у ссылок, только перед открывающей квадратной скобкой ставится восклицательный знак. Картинки «сноски»: ![Картинка][image1] ![Картинка][image2] ![Картинка][image3] [image1]: http://placehold.it/250x100 [image2]: http://placehold.it/200x100 [image3]: http://placehold.it/150x100 Картинки-ссылки: [![Alt text](http://placehold.it/150x100)](http://example.com/) ## Использование HTML внутри Markdown Mожно смешивать Markdown и HTML. Если на какие-то элементы нужно поставить классы или атрибуты, смело используем HTML: > Выделять слова можно при помощи * и _ . Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong. Можно и наоборот, внутри HTML-тегов использовать Маркдаун. section class="someclass"> ### Пример Маркдауна внутри HTML Выделять слова можно при помощи `*` и `_` . Например, это _italic_ и это тоже *italic*. А вот так уже __strong__, и так тоже **strong**. section> ### Таблицы В чистом Маркдауне нет синтаксиса для таблиц, а в GFM есть. First Header | Second Header ------------- | ------------- Content Cell | Content Cell Content Cell | Content Cell Для красоты можно и по бокам линии нарисовать: | First Header | Second Header | | ------------- | ------------- | | Content Cell | Content Cell | | Content Cell | Content Cell | Можно управлять выравниванием столбцов при помощи двоеточия. | Left-Aligned | Center Aligned | Right Aligned | |:------------- |:---------------:| -------------:| | col 3 is | some wordy text | **$1600** | | col 2 is | centered | $12 | | zebra stripes | are neat | ~~$1~~ | Внутри таблиц можно использовать ссылки, наклонный, жирный или зачеркнутый текст. Для всего остального есть обычный HTML. 

Памятка по markdown

Заголовки обособляются хешами (хеш справа для красоты) От количества хешей зависит уровень заголовка:

# Заголовок первого уровня () # ## Заголовок второго уровня () ## ### Заголовок третьего уровня () ### 

Главный заголовок можно не выделять хешами, а подчеркнуть двойной линией:

Погружение в маркдаун ================================================================================ 

Второй по главности заголовок можно не выделять хешами, а подчеркнуть простой линией:

Заголовки -------------------------------------------------------------------------------- 

Форматирование текста

Абзацы и переносы

Новый абзац в markdown определяется по наличию пустой строки перед блоком текста. Для того, чтобы сделать перенос внутри строки, достаточно добавить два пробела перед переносом строки.

Стилизация текста

• **Жирный текст** — Жирный текст
• *Курсивный текст* — Курсивный текст
• ***Жирный курсивный текст*** — Жирный курсивный текст

Горизонтальная линия

Горизонтальная линия в маркдауне до смешного проста

-------------------------------------------------------------------------------- Горизонтальная линия в маркдауне до смешного проста 

Вставка ссылок и картинок

• [Ссылка на котиков](http://placekitten.com/) — Ссылка на котиков
• 

В большом тексте удобно вставлять ссылки сносками как в книгах:

**В большом тексте** удобно вставлять ссылки [сносками][1] как в книгах: ---- [1]: http://placekitten.com/ "Cat happens" 

Списки

Обычный ненумерованный список

* один * два 

Обычный нумерованный список

1. один 2. два 

Форматирование кода

Блочное форматирование кода

Для блочного выделения кода достаточно сделать отступ в 4 пробела или один таб. Для такого представления:

Нужно вставить в редактор такой код:

Цитаты

Мы не поможем людям, делая за них то, что они могли бы сделать сами.

> Мы не поможем людям, делая за них то, что они могли бы сделать сами. 

Обычный HTML

Если что-то нельзя сделать в маркдауне, то используйте обычный HTML.

Markdown как перенести на новую строку

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

• Перенос строк
• Горизонтальные линии
• Картинка со ссылкой
• Использование HTML
• Отмена форматирования
• Использование специальных символов
• Официальная информация

Перенос строк

В некоторых текстах, например в поэзии, необходимо иметь возможность разделять абзац на несколько строк. Использование клавиши Enter не даст ожидаемого эффекта, т.к. по умолчанию отдельные строки соединяются вместе, чтобы текст выглядел как цельный абзац.

Люблю грозу в начале мая,
Когда весенний первый гром,
Как бы резвяся и играя,
Грохочет в небе голубом.

В приведенном выше стихотворении новую строку начинали, используя клавишу Enter, однако в результате эти переносы будут проигнорированы:

Люблю грозу в начале мая, Когда весенний первый гром, Как бы резвяся и играя, Грохочет в небе голубом.

Однако, если вы закончите строку двумя символами «пробел», то следующая начнется с новой строки:

Люблю грозу в начале мая,
Когда весенний первый гром,
Как бы резвяся и играя,
Грохочет в небе голубом.

Горизонтальные линии

Создать горизонтальную линию можно поместив три или больше звездочек (*), минусов (-) или подчеркиваний (_) на отдельной строке.

Такая строка создаст линию:

но вы можете разделять символы пробелами, чтобы сделать линию более очевидной в процессе редактирования документа.

_ _ _ _ _

Каждая из приведенных выше строк даст одинаковый результат. Вот такой:

Картинка со ссылкой

В документе «Форматирование текста с помощью Markdown» уже были приведены инструкции для создания web-ссылок и вставки картинок. Однако вы можете совместить две эти возможности и создать картинку, которая является еще и ссылкой на какую-нибудь страницу в сети.

[Поисковая система Google][google]

![Логотип Google][logo]

Выше приведены обычная ссылка и обычное изображение. Вы можете поместите картинку туда, где указан текст ссылки, например:

[![Логотип Google][logo]][google]

Нужно помнить, что приведенные выше ссылки должны быть определены где-либо в документе:

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ «щелкните, чтобы посетить Google.com»

Такое совмещение создает картинку, щелчок по которой переместит вас на указанную ссылку:

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

Списки определений

Списки определений содержат термины и их описания. Это выглядит подобно словарю. Ниже простой пример: Definition lists consist of terms followed by their definitions. Rather like a dictionary. A simple example is as follows:

Moodle : Хорошо известная платформа для онлайнового обучения PHP : Язык программирования. Часто используется для разработки интерактивных веб-приложений.

Moodle Хорошо известная платформа для онлайнового обучения PHP Язык программирования. Часто используется для разработки интерактивных веб-приложений.

Сноски

Сноска состоит из двух элементов: маркера в тексте в виде цифры в верхнем индексе и описания, которое отображается внизу страницы. Пример:

Прочтите об этом в моей книге.[^1] [^1]: Все о моей книге.

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

Использование HTML

Если вы являетесь специалистом в HTML, то можете обнаружить, что Markdown не дает вам всех возможностей, которые вы бы хотели. К счастью Markdown разрабатывался с учетом этого и позволяет вставлять теги HTML непосредственно в форматируемый текст.

* мелкий текст
* крупный текст

Имейте в виду, что HTML-разметка сосуществует с разметкой Markdown. Это освобождает вас от необходимости использовать HTML для основных элементов оформления, таких как параграфы, списки и т.п., однако в необходимых случаях позволяет использовать все возможности HTML.

Отмена форматирования

Если, в отличии от предыдущей главы, вы хотите, чтобы введенные теги HTML отображались в точности как вы их написали, а не использовались в оформлении текста, то начните каждую строку с четырех пробелов.

Абзац с тегами HTML отображается без изменений
 

Кроме того, это используется для отображения текста программ:

for (int i=0; i

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

В обычном состоянии это слово было бы **полужирным**. 

Об использовании специальных символов в обычном тексте читайте в следующей главе.

Использование специальных символов

Если вы хотите отобразить любой из специальных символов Markdown вместо того, чтобы использовать его для форматирования, просто поставьте перед ним символ обратной косой черты (\). Сама косая черта не отображается, однако следующий за ней символ будет показан как есть:

\*звездочки, а не курсив\*

*звездочки, а не курсив*.

*курсив, а не звездочки*,

курсив, а не звездочки.