Додаткові можливості Markdown

У цій статті розглядаються деякі додаткові способи форматування, які дозволяють максимально використати можливості формату Markdown. Якщо ви почуєте, що описані тут можливості зараз вам не потрібні, то пропустите цей документ і поверніться до нього тоді, коли вони вам знадобляться.

Перенос рядків

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

Ще на жаль таке буває:
Хто працює - той мовчить,
А від цього користь має
Той, хто дуже цвірінчить.

У наведеному вище вірші новий рядок створюється шляхом використання клавіші Enter, однак у результаті ці переноси будуть ігноровані:

Ще на жаль таке буває: Хто працює - той мовчить, А від цього користь має Той, хто дуже цвірінчить.

Однак, якщо закінчити рядок двома символами "пробіл" та клавіша Enter, то наступний текст почнеться з нового рядка:

Ще на жаль таке буває:
Хто працює - той мовчить,
А від цього користь має
Той, хто дуже цвірінчить.

Горизонтальні лінії

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

Такий рядок створить лінію:

***

можна також розділити символи пробілами, щоб зробити лінію більш очевидною при редагуванні документа.

* * * * *

-------------------------

_ _ _ _ _

Кожний з наведених вище рядків дасть однаковий результат:


Зображення з посиланням

У документі "Форматування тексту за допомогою Markdown" вже були наведені інструкції для створення web-посилань і посилань до файлів зображень. Можна також об'єднати ці дві можливості і створити зображення, яке є посиланням на будь-яку сторінку в мережі Інтернет.

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

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

Вище наведені приклади звичайного web-посилання і посилання до файлу зображення. Об'єднання цих посилань можна виконати наступним чином:

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

Потрібно пам'ятати, що наведені вище посилання повинні бути визначені будь-де у документі:

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "клацніть, щоб відвідати Google.com"

Таке об'єднання створює зображення з посиланням, за яким можна переміститися до бажаної сторінки Інтернет:

Логотип Google

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

Таблиці

В тексті можуть бути створені також прості таблиці.

Наступна розмітка таблиці:

Ім'я          |   Вік
--------------|:---------:
Петро | 29
Дмитро | 25
Ганна | 18

дасть

Им'я   Вік  
Петро 29
Дмитро 25
Ганна 18

В середині комірок можна використовувати звичайні способи розташування тексту. Стовпці можуть бути вирівняні по правому, лівому краям або по центру за допомогою двокрапок у рядку, який відділяє заголовок таблиці від її змісту.

Списки визначень

Списки визначень містять терміни та їх визначення. Це виглядає подібно словнику. Нижче простий приклад:

Moodle
:   Добре відома платформа для онлайнового навчання.
PHP
:   Мова програмування.
    Часто використовується для розробки інтерактивних веб-додатків.
Moodle
Добре відома платформа для онлайнового навчання.
PHP
Мова програмування. Часто використовується для розробки інтерактивних веб-додатків.

Виноски

Виноска складається із двох елементів: маркера у вигляді символу "кришечка" і числа, які розміщуються в тексті документа, та опису, який буде показаний внизу сторінки.

Приклад:

Прочитайте про це в моїй книзі.[^1]

[^1]: Усе про мою книгу.

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

Використання HTML

Markdown не надає всіх можливостей використання HTML, які ви б хотіли. Але на щастя він розроблявся з врахуванням таких можливостей і дозволяє вставляти HTML-теги безпосередньо у текст, що форматується.

* <small>маленькі літери</small>
* <big>великі літери</big>

  • маленькі літери
  • великі літери

Майте на увазі, що HTML-розмітка співіснує з розміткою Markdown. Це звільняє вас від необхідності використання HTML-розмітки для оформлення основних елементів тексту, таких як параграфи, списки і т.і. Однак, у необхідних випадках він дозволяє використовувати всі можливості HTML.

Скасування форматування

Якщо, на відмінність від попереднього розділу, необхідно, щоб введені HTML-теги не використовувалися в оформленні тексту, а показувалися в точності, як ви їх написали, то рядок тексту треба розпочати з чотирьох пробілів.

<p>A paragraph in <b>HTML</b> displayed as code</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/

Moodle використовує версію Markdown з додатковими особливостями, відомими як "Markdown Extra". Детальна інформація про цю версію може бути знайдена за посиланням http://www.michelf.com/projects/php-markdown/extra/ .

Перелік усіх файлів допомоги
Показати сторінку допомоги мовою: English