Перегляд вихідного коду сторінки Markdown

{{Infobox file format
| name                   = Markdown
| icon                   =
| logo                   = [[Файл:Markdown-mark.svg]]
| screenshot             =
| caption                =
| extension              = .md, .markdown
| mime                   = text/markdown
| type code              =
| uniform type           = net.daringfireball.markdown
| magic                  =
| owner                  = {{не перекладено|Джон Грубер|||John Gruber}}
| licence                = [[Ліцензія BSD]]
| released               = {{Дата релізу та вік|2004|3|19}}
| latest release version = 1.0.1
| latest release date    = {{Дата релізу та вік|2004|12|17}}
| genre                  = [[Мова розмітки даних]]
| container for          =
| contained by           =
| extended from          =
| extended to            = [[MultiMarkdown]], [[#Markdown Extra|Markdown Extra]], CommonMark
| standard               =
| url                    = {{url|http://daringfireball.net/projects/markdown/}}
}}

'''«Markdown»''' ({{МФА-всі|маркда́ун}})&nbsp;— полегшена [[мова розмітки даних]], яку створено з ухилом на [[прочитність]] та зручність у публікації з подальшим перетворенням її на ''structurally valid'' [[XHTML]] або [[HTML]]. Чимало ідей для мови позичено з існуючих домовленостей у розмітці [[Текстові дані|тексту]] в [[Електронна пошта|електронних листах]]. Першу реалізацію ''Markdown'' написано Грубером на ''[[Perl]]'', але з часом з'явились багато реалізацій від сторонніх розробників (див. [[#Реалізації Markdown|нижче]]). Реалізація на ''Perl'' розповсюджується за [[Ліцензія BSD|ліцензією BSD]]. Реалізації ''Markdown'' різними [[Мова програмування|мовами програмування]] включені (або наявні як [[плаґін]]и) у численні [[Система керування вмістом|системи керування вмістом]].

Такі сайти, як ''[[GitHub]]'', ''[[Reddit]]'' та ''[[Stack Overflow]]'' використовують ''Markdown'' для полегшення обговорень між користувачами<ref>{{Cite web|назва=GitHub Flavored Markdown|url=https://help.github.com/articles/github-flavored-markdown|видавець=[[GitHub]]|дата-доступу=29 березня 2013}}</ref><ref>{{Cite web|назва=Приклад Markdown у Reddit. Або, іншими словами, як зробити гламурне форматування ваших коментарів|url=http://www.reddit.com/r/reddit.com/comments/6ewgt/reddit_markdown_primer_or_how_do_you_do_all_that/|видавець=[[Reddit]]|url-архіву=https://www.webcitation.org/6JB0tFBun?url=http://www.reddit.com/r/reddit.com/comments/6ewgt/reddit_markdown_primer_or_how_do_you_do_all_that/|дата-архіву=27 серпень 2013|мертвий-url=no|дата-доступу=29 березня 2013}}</ref><ref>{{Cite web|назва=Допомога з Markdown|url=http://stackoverflow.com/editing-help|видавець=[[Stack Overflow]]|url-архіву=https://www.webcitation.org/6JB0uAaNQ?url=http://stackoverflow.com/editing-help|дата-архіву=27 серпень 2013|мертвий-url=no|дата-доступу=29 березня 2013}}</ref>.

== Приклади синтаксису ==
Цей опис не є вичерпним переліком синтаксису Markdown, та у багатьох випадках для досягнення певного ефекту існує декілька стилів синтаксису<ref>{{Cite web|url=http://daringfireball.net/projects/markdown/syntax|назва=Повний синтаксис Markdown}}</ref>. Літери, які Markdown однозначно визначає як команди форматування, можуть бути екрановані [[Обернена коса риска|бекслешем]]; наприклад, вираз <code>'\*'</code> виведе зірочку, а не означатиме початку проміжку виділеного тексту. Також Markdown не перетворює текст із «сирим» [[XHTML]]-елементом блокового рівня. Це дозволяє включати секції XHTML у джерело Markdown документа, обернувши їх в XHTML теги блокового рівня.

=== Заголовки ===
[[HTML]]-заголовки створюються розміщенням числа "решіток" перед текстом заголовка відповідно до баженого рівня (HTML підтримує 6 рівнів озаглавлення), наприклад:
<source lang="markdown">
 # заголовок першого рівня

 #### заголовок четвертого рівня
</source>
Перші два рівні заголовків також мають альтернативний синтаксис:
<source lang="markdown">
Заголовок першого рівня
=======================

Заголовок другого рівня
-----------------------
</source>

=== Параграфи ===
Параграф є одним чи декількома послідовними рядками тексту, які розділяються одним чи декількома порожніми рядками. Звичайні параграфи не повинні мати відступи або табуляцію:

<source lang="markdown">Це параграф. Він містить два речення.

Це інший параграф. Він також містить два речення.</source>

=== Список ===
<source lang="markdown">
 * Пункт в маркованому (ненумерованому) списку
     * Підпункт, відділений 4 пробілами
 * Інший пункт в маркованому списку

 1. Пункт в нумерованому списку
     1.1. Підпункт, відділений 4 пробілами
 2. Інший пункт в нумерованому списку
</source>

=== Виділений текст ===
<source lang="markdown">
 *emphasis* або _emphasis_ (тобто нахил)

 **сильне виділення** або __сильне виділення__ (тобто напівжирний)
</source>

=== Код ===
Для включення коду (відформатованого в моноширинний шрифт), ви можете або оточити вбудований код зворотніми лапками (<code>`</code>), наприклад, <code>`деяким кодом`</code>, або відділити декілька рядків кода щонайменше чотирма пробілами, як тут:
<source lang="markdown">
    перший рядок кода
    другий рядок кода
    третій рядок кода
</source>
Останній варіант за допомогою пробілів дозволяє зберігати і показувати синтаксис Markdown.

=== Кінець рядка ===
Якщо ви хочете вставити закінчення рядка Markdown, закінчіть рядок з щонайменше двома пробілами.

Наприклад:
<source lang="markdown">
 def show_results space space
 end
</source>

Результат:
<source lang="markdown">
 def show_results
 end
</source>

Ви також можете використати два порожніх рядки, наприклад:
<source lang="markdown">
 sentence A
 
 sentence B
</source>

Результат:
<source lang="markdown">
 sentence A
 sentence B
</source>

=== Цитати ===
<source lang="markdown">
 > "Весь цей абзац тексту буде поміщений у HTML blockquote елемент.
 Blockquote елементи змінюються в залежності від потреби/пристрою виводу.
 Ви можете обернути довільний текст за власним смаком, та воно перетвориться
 на єдиний blockquote елемент."
</source>

Приклад вище перетвориться на такий HTML:
<source lang="html4strict">
<blockquote><p>Весь цей абзац тексту буде поміщений у HTML blockquote елемент.
 Blockquote елементи змінюються в залежності від потреби/пристрою виводу.
 Ви можете обернути довільний текст за власним смаком, та воно перетвориться
 на єдиний blockquote елемент.</p></blockquote>
</source>

=== Зовнішні посилання ===
Посилання можуть бути вбудованими:
<source lang="markdown">
 [текст посилання](адреса посилання)
</source>
Наприклад: <code>[Markdown](<nowiki>http://en.wikipedia.com/wiki/Markdown</nowiki>)</code>

Також посилання можуть бути розміщені у примітках поза параграфом, наприклад:
<source lang="markdown">
 [текст посилання][linkref]
</source>

створить посилання, якщо додати примітку (як показано нижче) поза параграфом (або в кінці документу):
<source lang="markdown">
 [linkref]: link.address.here "link title here"
</source>

=== Зображення ===
Зображення мають схожий із посиланнями синтаксис з попереднім знаком оклику.
<source lang="markdown">
[Alt text](/path/to/img.jpg)
</source>

Або:
<source lang="markdown">
[Alt text](/path/to/img.jpg "Optional title")
</source>

Як і посилання, зображення також мають примітковий стиль синтаксису
<source lang="markdown">
[Alt text][id]
</source>

з пізнім посиланням в документі, яке визначає URL розміщення.
<source lang="markdown">
 [id]: url/to/image "Optional title attribute"
</source>

=== Горизонтальні лінії ===
Горизонтальні лінії задаються розміщенням трьох або більшим дефісів, зірочок, або підкресленням в рядку самостійно. Ви можете використовувати пробіли між дефісами чи зірочками. Кожен з наведених нижче рядків створить горизонтальну лінію:
<source lang="markdown">
 * * *
 ***
 *****
 - - -
 ---------------------------------------
</source>

== Редактори ==
Хоча Markdown є полегшеною мовою розмітки яку легко читати та редагувати звичайними текстовими редакторами, існують спеціально розроблені редактори, які дозволяють попередньо переглядати зі стилями. Є безліч таких редакторів, які наявні для всіх основних платформ. Існує плаґін [[Підсвітка синтаксису|підсвітки синтаксису]] для Markdown, вбудований у [[gedit]] та [[Vim]].

== Реалізації ==
Реалізації Markdown існують для багатьох різних фреймворків, платформ та мов.
* Система документації джерельних текстів [[Doxygen]] підтримує Markdown з додатковими можливостями{{Fact|дата=березень 2013}}.
* [[RStudio]], IDE для [[R (мова програмування)|R]] підтримує [[C++]] {{не перекладено|Обгортка функції|обгортку функцій||Wrapper function}} для реалізації markdown [[Sundown]]<ref>https://github.com/rstudio/rstudio/blob/master/src/cpp/core/markdown/Markdown.cpp</ref>.
* [[IntelliJ IDEA]], IDE для [[Java (мова програмування)|Java]], містить плаґін для підтримки Markdown<ref>{{Cite web|url\http://plugins.jetbrains.com/plugin?id=5970}}</ref><ref>{{Cite web|url=https://github.com/nicoulaj/idea-markdown}}</ref>.
* Існують формат і програма [[MultiMarkdown]] з ширшим синтаксисом та можливостями експорту, ніж в традиційній Markdown.

Існує багато іншого [[Відкрите програмне забезпечення|відкритого програмного забезпечення]] реалізації Markdown, доступного в мережі.

=== Markdown Extra ===
Markdown Extra - це [[легка мова розмітки]] на основі Markdown реалізована в [[PHP]] (початково), [[Python]] та [[Ruby]]. Вона містить функції недоступні в звичайному синтаксисі Markdown. Markdown Extra підтримується [[Система керування вмістом|системами керування вмістом]], наприклад [[Drupal]],<ref>[https://drupal.org/project/markdowneditor Markdown editor for BUEditor]</ref> [[TYPO3]]<ref>[http://typo3.org/extensions/repository/view/markdown_content Markdown for TYPO3]</ref> та [[MediaWiki]].<ref>[http://www.mediawiki.org/wiki/Extension:MarkdownExtraParser MarkdownExtraParser for MediaWiki]</ref>

Додає наступні функції до Markdown:
* Markdown всередині блоків [[HTML]]
* Елементи з атрибутами id/class
* "обгороджені" блоки коду ({{lang-en|Fenced code blocks}})
* Таблиці<ref>[http://michelf.com/projects/php-markdown/extra/#table PHP Markdown Extra - Tables]</ref>
* Списки означень (dl)
* Зноски
* Абревіатури

== Див. також ==
* [[Розширення Markdown]]
* [[Org-mode]] має подібну полегшену розмітку.
* [[txt2tags]], інша полегшена мова розмітки.
* [[Setext]], стара полегшена мова розмітки(1992).

== Посилання ==
{{reflist}}

== Зовнішні посилання ==
* [http://daringfireball.net/projects/markdown/ Official Markdown project at Daring Fireball]
* [https://www.raywenderlich.com/119949/top-five-markdown-editors Огляд Markdown редакторів для OS X (Raywenderlich)]{{ref-en}}

{{Мови розмітки}}
[[Категорія:Мови розмітки даних]]
[[Категорія:Конспектування]]