Markdown (маркдаун) — облегчённый язык разметки, созданный с целью написания максимально читабельного и удобного для правки текста, но пригодного для преобразования в языки для продвинутых публикаций (HTML, Rich Text и др.).
История
Первоначально создан в 2004 году Джоном Грубером (англ. John Gruber) и Аароном Шварцем. Многие идеи языка были позаимствованы из существующих соглашений по разметке текста в электронных письмах. Реализации языка Markdown преобразуют текст в формате Markdown в валидный, правильно построенный XHTML и заменяют левые угловые скобки («<») и амперсанды («&») на соответствующие коды сущностей. Первой реализацией Markdown стала написанная Грубером реализация на Perl, однако спустя некоторое время появилось множество реализаций от сторонних разработчиков (см. ниже). Реализация на Perl распространяется по лицензии типа BSD. Реализации Markdown на различных языках программирования включены (или доступны в качестве плагина) во многие системы управления содержимым.
Примеры синтаксиса
Ниже приведены примеры использования Markdown, однако это далеко не полное руководство. Полное описание языка может быть найдено на официальном сайте. Символы, которые обычно рассматриваются в Markdown как специальные, могут быть экранированы с помощью обратного слеша. Например, последовательность «\*» выведет символ «*», а не будет являться признаком начала выделенного текста. Кроме того, Markdown не преобразует текст внутри «сырых» блоков XHTML. Таким образом, в Markdown-документ можно включать секции XHTML, заключив их предварительно в теги уровня блока.
Текст с выделением или логическим ударением:
*выделение* (например, курсив) **сильное выделение** (например, полужирное начертание)
* элемент маркированного списка - ещё один элемент ненумерованного списка + буллеты элементов могут быть разными
1. Элемент нумерованного списка
2. Элемент №2 того же списка
9. Элемент №3 списка — элементы нумеруются по порядку, цифра в начале строки не имеет значения
Заголовки:
Создание заголовков производится путём помещения знака решетки перед текстом заголовка. Количество знаков «#» соответствует уровню заголовка. HTML предоставляет 6 уровней заголовков.
# Заголовок первого уровня #### Заголовок четвёртого уровня
Первые два уровня заголовка также имеют альтернативный синтаксис:
Text::MultiMarkdown (Perl) модуль, реализующий расширение MultiMarkdown
PHP Markdown Extra
python-markdown2 (Поддерживает некоторые расширения PHP Markdown)
python-markdown (Имеет систему расширений для добавления нового синтаксиса
Markout (Java)
Pegdown (Java)
Maruku (Ruby)
Pandoc (Haskell)
Руководства
Markdown: Dingus онлайн-конвертер
Markdown cheat sheet
Конвертеры
из HTML в Markdown
html2text.py (написано на Python)
Markdownify (на PHP)
Make.text — букмарклет, преобразующий любую веб-страницу в Markdown
XHTML-to-Markdown XSLT (XSLT-таблица стилей, работает только с XHTML)
Pandoc — написанная на Haskell библиотека по преобразованию различных форматов, поддерживает несколько диалектов Markdown (markdown — диалект от pandoc, markdown_strict — оригинальный Markdown без расширений, markdown_phpextra — диалект от PHP, markdown_github — диалект от github) может преобразовывать из и в Markdown, HTML, reStructuredText, LaTeX, и другие.
Другие форматы в Markdown
odt2txt (написанный на Python скрипт для преобразования файлов из формата OpenDocument в Markdown)
word_markdown_macro (макрос Microsoft Word, преобразующий некоторую часть форматирования Word в Markdown)
Веб-приложения, использующие Markdown
Вики:
DokuWiki (с помощью плагина)
ikiwiki
Oddmuse
PmWiki (с помощью плагина)
Блоги:
Tumblr — изначально отключён, но можно использовать, включив в настройках.
scriptogr.am
CMS:
Drupal — content-фильтр Markdown
Magento — с помощью модуля
Plone — «родная» поддержка в Plone 3
TYPO3 — с помощью плагина af_markdown
RadiantCMS — один из видов разметки, доступный «из коробки»
Веб-фреймворки:
Ruby on Rails — требуется установка BlueCloth, Maruku
Yii — виджет CMarkdown, входит в стандартную поставку фреймворка
Yii2 - хелпер Markdown, входит в стандартную поставку фреймворка
Webasyst — входит в стандартную поставку PHP-фреймфорка в виде плагина к бесплатному приложению «Блог»
Социальные сети:
Steem - социальная сеть, основанная на блокчейне.
Поддержка текстовыми редакторами
Универсальные редакторы: TextMate, BBEdit (с версии 8.6), Vim (с помощью специального пользовательского режима[46], написанного Беном Вильямсом), Emacs(с помощью специального пользовательского режима, написанного Джейсоном Блевинсом), TextWrangler, Smultron, Sublime Text, Geany, Atom.
Редакторы для блогов: Ecto, MarsEdit
Плагины для редактора среды Eclipse от ThinkTank Mathematics
