Дополнительные возможности 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

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

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

Списки определений содержат термины и их описания. Это выглядит подобно словарю. Ниже простой пример: 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 непосредственно в форматируемый текст.

* <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/

Список всех файлов помощи
Показать эту помощь на языке: English