Дополнительные возможности Markdown

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

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

В некоторых текстах, например в поэзии, необходимо иметь возможность разделять абзац на несколько строк. Использование клавиши 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"

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

Логотип Google

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

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

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

* <small>мелкий текст</small>
* <big>крупный текст</big>

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

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

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

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

<p>Абзац с тегами <b>HTML</b> отображается без изменений</p>

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

for (int i=0; i<5; i++) {
   print "Command-line arguments: (@ARGV)\n";
}

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

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

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

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

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

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

превращается в

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

в отличии от

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

которое даст

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

Официальная информация

Система форматирования Markdown не является иключительно частью Moodle. Этот формат используется во многих других системах публикации информации в Сети. Вы можете найти более подробную информацию о Markdown на официальном сайте http://daringfireball.net/projects/markdown/

Список всех файлов помощи