Включите исполнение JavaScript в браузере, чтобы запустить приложение.

Синтаксис и использование Markdown Basic

Почему Markdown так популярен? На простых примерах объясняем синтаксис языка разметки и показываем, как с его помощью выполнить форматирование текста.

Основы Markdown и его популярность в форматировании текста

Markdown — удобный язык разметки с простой конвертацией в html. Его разновидности поддерживают самые разные платформы, включая Microsoft Lean, Telegram, Trello, GitHub. То есть маркдаун востребован в широком диапазоне проектов: от текстовых редакторов типа Atom до блог-платформ и сервисов, ориентированных на сферу проджект-менеджмента.

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

Разновидности и редакторы

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

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

  • GitHub Flavored Markdown;
  • Markdown Editor.

Ниже приводим шпаргалку по использованию этого языка разметки на примере Маркдаун Эдитор.

Синтаксис Markdown

Разделение и перенос строк

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

Разбивка на абзацы
Разбивка на абзацы

Иногда в тексте нужно разместить строки одну под другой, не разделяя их на отдельные абзацы. Для этого в Md предусмотрено целых три способа.

Вы можете:

  • закончить строку одним или несколькими пробелами либо поставить обратный слеш (\) впритык к последнему слову;
  • перед фразой, которую нужно перенести вниз, вписать html-тег <br>.
Разбивка по строкам
Разбивка по строкам

Обратите внимание, что если написать все фразы из примера выше в одну строку, то перенесется только последняя фраза. Поэтому не забывайте пользоваться клавишей Enter и нашей шпаргалкой.

Это так не работает!
Это так не работает!

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

Заголовки

В привычном Word и Google Docs обычно используется четыре уровня заголовков. В Markdown пользователю доступно шесть уровней. Основной заголовок принято обозначать H1, подзаголовки нумеруются по возрастающей. Так, h3 вложен в h2, а h4 будет находиться внутри h3. 

Чтобы превратить текст в заголовок, перед ним в начале строки нужно поставить символ решетки (#). Причем количество решеток должно соответствовать уровню подзаголовка, а между самим символом и текстом нужно поставить пробел. Иногда в синтаксисе Маркдаун решетки можно встретить в начале и в конце строки. Ошибкой это не считается, однако задняя # не оказывает никакого влияния на формирование уровня заголовка.

Создание заголовков любого уровня
Создание заголовков любого уровня

Для отображения заголовков можно воспользоваться другим способом. В нем вместо символа решетки для заголовков первого уровня используется знак «равно», для подзаголовков второго уровня — дефис. Данные символы вписываются в строку под самим заголовком и не подходят для отображения подзаголовков более низких ступеней.

Количество символов «дефис» или «равно» значения не имеет. Программа распознает как один знак, так и длинный массив. Если в одной строке прописать оба знака, заголовок создать не получится — Md не сможет распознать такую команду.

Создание h1 и h2
Создание h1 и h2

Шпаргалка по выделению текста

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

Чтобы подчеркнуть важную информацию, вам потребуется вписать HTML-тег <u> или </u> в конце выделяемой фразы. Обратите внимание, что между тегом и текстом можно поставить пробел — на результат это тоже не повлияет.

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

Оформление подчеркивания текста
Оформление подчеркивания текста

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

Чтобы форматировать текст в курсив, поставьте в начале и в конце текста звездочку или одинарное нижнее подчеркивание. При этом пробелов между символом * и буквами быть не должно. Примечательно, что сразу после постановки звездочки либо подчеркивания текст в редакторе меняет свое начертание на курсив.

Создание курсива
Создание курсива

Списки — еще один элемент, который часто встречается в самых разных текстовых документах. Мы подготовили простой guide, как их сделать. 

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

Создание списков
Создание списков

Чтобы создать зачеркнутый текст, можно пользоваться двойным символом «Тильда», который выглядит как короткая волнистая черточка. На клавиатуре он находится на одной клавише с буквой «ё». 

Значки ставятся впритык к тексту, без пробелов между ними и буквами в начале и в конце строки. Интересно, что если «тильда» будет стоять только перед буквами, то Markdown Editor в программной строке отобразит текст зачеркнутым, но браузер не распознает такое форматирование. Поэтому двойной символ должен стоять с двух сторон текста — это особенность syntax данного языка разметки.

Форматирование текста в зачеркнутый
Форматирование текста в зачеркнутый

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

Как с помощью syntax Md сделать шрифт жирным? Для решения этой задачи также есть простое решение. Достаточно поставить подряд до и после текста два символа звездочки или нижнего подчеркивания.

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

Выделение жирным
Выделение жирным

В некоторых случаях нужно скомбинировать, например, жирный шрифт и зачеркивание. Для этого без пробелов проставляем последовательность из двойных символов «тильда» и звездочек в начале строки, а затем в конце нужной фразы. Аналогичным образом в вашем текстовом file можно создать жирный курсив, поставив с двух сторон текста по три *.

Комбинация разных способов форматирования
Комбинация разных способов форматирования

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

Изображения

Чтобы вставить картинку, следуйте алгоритму:

  • поставьте в начале строки восклицательный знак;
  • откройте квадратную скобку;
  • напишите текст — подпись к изображению;
  • закройте квадратную скобку;
  • откройте обычную полукруглую скобку;
  • вставьте ссылку с указанием пути к картинке;
  • закройте скобку.
Вставка изображений
Вставка изображений

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

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

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