Markdown

Материал из Википедии — свободной энциклопедии

Markdown (маркдаун) — легковесный язык разметки. Первоначально создан Джоном Грубером и Аароном Шварцем, целью которых являлось создание максимально удобочитаемого и удобного в публикации легковесного языка разметки. Многие идеи языка были позаимствованы из существующих правил разметки электронных писем в виде plain text. Реализации языка Markdown преобразуют текст в формате Markdown в валидный, правильно построенный XHTML и заменяет левые углобые скобки («<») и амперсанды на соответсвующие коды сущностей. Первой реализацией Markdown стала написанная Грубером реализация на Perl, однако спустя некоторое время появилось множество реализаций от сторонних разработчиков (см. список). Реализация на Perl распространяется по лицензии типа BSD. Реализации Markdown на различных языках программирования включены (или доступны в качестве плагина) во многие системы управления содержимым.

Содержание 1 Примеры синтаксиса 2 Реализации Markdown 2.1 Расширения 2.2 Руководства 2.3 Конвертеры 2.4 Веб-приложения, использующие Markdown 3 Поддержка текстовыми редакторами 4 См. также 5 Примечания 6 Ссылки

[править] Примеры синтаксиса

Ниже приведены примеры использования markdown, однако это далеко не полное руководство. Полное описание языка может быть найдено в ^[1]. Символы, которые обычно рассматриваются в markdown как специальные, могут быть экранированы с помощью обратного слэша. Например, последовательность «\*» выведет символ «*», а не будет являться признаком начала выделенного текста. Кроме того, Markdown не преобразует текст внутри «сырых» блоков XHTML. Таким образом, в markdown-документ можно включать секции XHTML, заключив их предварительно в теги уровня блока.

• Текст с выделением или логическим ударением:

 *выделение* (например, курсив)
 **сильное выделение** (например, полужирное начертание)

• Программный код:

 `какой_то_программный_код($аргумент)`

• Списки:

 -элемент маркированного списка
 -ещё один элемент не нумерованного списка

 1. Элемент нумерованного списка
 2. Элемент №2 того же списка

• Заголовки:

Создание заголовков производится путём помещения знака решетки перед текстом заголовка. Количество знаков "#" соответствует уровню заголовка. HTML предоставляет 6 уровней заголовков.

# Заголовок первого уровня
#### Заголовок четвёртого уровня

Первые два уровня заголовка также имеют альтернативный синтаксис:

Заголовок первого уровня
========================

Заголовок второго уровня
------------------------

• Цитаты (тег blockquote):

>Данный текст будет заключен в HTML-теги <blockquote></blockquote>

• Ссылки:

[Текст ссылки](адрес://ссылки.здесь "Заголовок ссылки")

• Изображения:

![Alt-текст](URL изображения "Заголовок изображения")

[править] Реализации Markdown

• C#: Markdown.NET
• C: markdown
• ColdFusion: CFX_Markdown
• Common Lisp: cl-markdown
• Haskell: Pandoc
• Java: markdownj
• JavaScript: Showdown
• Lua: markdown.lua
• newLISP: markdown-newlisp
• Perl: Text::Markdown
• PHP: PHP Markdown
• Python: python-markdown и python-markdown2
• Ruby: BlueCloth
• Ruby: Maruku

[править] Расширения

Приведённые ниже приложения реализуют Markdown, расширяя его синтаксис дополнительной функциональностью:

• MultiMarkdown (Perl)
• PHP Markdown Extra
• python-markdown2 (Поддерживает некоторые расширения PHP Markdown)
• python-markdown (Имеет систему расширений для добавления нового синтаксиса)
• Markout (Java)
• Maruku (Ruby)
• Pandoc (Haskell): см. (англ.) markdown от Pandoc против стандартного markdown

[править] Руководства

• Markdown: Dingus онлайн-конвертер
• Markdown cheat sheet

[править] Конвертеры

• из HTML в Markdown
  • html2text.py (написано на Python)
  • Markdownify (на PHP)
  • Make.text (букмарклет, преобразующий любую веб-страницу в Markdown)
  • XHTML-to-Markdown XSLT (XSLT-таблица стилей, работает только с XHTML)
  • Pandoc (написанная на Haskell библиотека по преобразованию различных форматов, может преобразовывать из и в Markdown, HTML, reStructuredText, LaTeX, и другие)
• Другие форматы в Markdown
  • Pandoc (написанная на Haskell библиотека по преобразованию различных форматов, может преобразовывать из и в Markdown, HTML, reStructuredText, LaTeX, и другие)
  • odt2txt (написанный на Python скрипт для преобразования файлов из формата OpenDocument в Markdown)
  • word_markdown_macro (Макрос Microsoft Word, преобразующий некоторую часть форматирования Word в Markdown)

[править] Веб-приложения, использующие Markdown

• Вики:
  • DokuWiki (с помощью плагина)
  • ikiwiki
  • Oddmuse
  • PmWiki (с помощью плагина)
• Блоги:
• CMS:
  • Drupal — см. модуль marksmarty
  • Plone — «родная» поддержка в Plone 3
  • TYPO3 — с помощью плагина af_markdown
• Веб-фреймворки:
  • Django — требуется установка python-markdown, см. django.contrib.markdown
  • Ruby on Rails — требуется установка BlueCloth или Maruku, см. Markdown в RoR

[править] Поддержка текстовыми редакторами

• Универсальные редакторы: TextMate, BBEdit (с версии 8.6), vim (с помощью специального пользовательского режима, написанного Беном Вильямсом), Emacs, TextWrangler, Smultron
• Редакторы для блогов: Ecto, MarsEdit
• Существуют плагины для редактора среды Eclipse от ThinkTank Mathematics

[править] См. также

• Markdown extra
• Список легковесных языков разметки

[править] Примечания

1. ↑ Официальный сайт (англ.). На сайте приведено полное и исчерпывающее описание синтаксиса Markdown.

[править] Ссылки

Markdown вики (англ.)