Русская Википедия:Markdown

Markdown (МФА: Шаблон:МФА2, произносится маркда́ун) — облегчённый язык разметки, созданный с целью обозначения форматирования в простом тексте, с максимальным сохранением его читаемости человеком, и пригодный для машинного преобразования в языки для продвинутых публикаций (HTML, Rich Text и других).

История

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

Примеры синтаксиса

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

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

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

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

Элементы кода могут быть внутри строки (inline) либо многострочными блоками.

Внутри строки код выделяется символом "`" (обратный апостроф).

Пример кода внутри строки (inline) `Hello world!`

Многострочный блок кода обозначается отступом из 4 пробелов или одного Tab.

Ниже начинается многострочный блок кода

    <!doctype html>
    <html>
        <head>
            <!-- Заголовок документа -->
        </head>
        <body>
            <!-- Тело документа -->
        </body>
    </html>

Блок кода завершился

Зачёркнутый текст

необходимо сделать ~~одну~~ другую вещь

Списки

* элемент маркированного списка
- ещё один элемент ненумерованного списка
+ буллеты элементов могут быть разными

1. Элемент нумерованного списка
2. Элемент №2 того же списка
9. Элемент №3 списка — элементы нумеруются по порядку, цифра в начале строки не имеет значения

Заголовки

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

# Заголовок первого уровня
...
### Заголовок третьего уровня
...
###### Заголовок шестого уровня

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

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

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

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

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

Ссылки

[Текст ссылки](http://example.com/ "Необязательный заголовок ссылки")

Альтернативный способ задавать ссылки, если есть повторения:

Где-то среди текста встречается [текст ссылки][example].

Также ссылка повторяется [пример адреса][example].

Ссылка на [второй][foo] также [Bar][] ресурсы.

[example]: http://example.com/ "Необязательный заголовок ссылки"
[foo]: http://example.net/ 'Необязательный заголовок ссылки'
[bar]: http://example.edu/ (Необязательный заголовок ссылки)

Изображения

![Alt-текст](http://example.com/ "Заголовок изображения")

Реализации Markdown

Расширения

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

MultiMarkdown (C)^[27]
Text::MultiMarkdown (Perl) модуль, реализующий расширение MultiMarkdown^[28]
PHP Markdown Extra^[29]
python-markdown2 (Поддерживает некоторые расширения PHP Markdown)^[22]
python-markdown (Имеет систему расширений для добавления нового синтаксиса)^[21]
Markout (Java)^[30]
Pegdown (Java)^[13]
Maruku (Ruby)^[24]
Pandoc (Haskell)^[11]^[31]

Руководства

Markdown: Dingus онлайн-конвертер^[32]
Markdown cheat sheet^[33]

Конвертеры

из HTML в Markdown
- html2text.py (написано на Python)^[34]
- Markdownify (на PHP)^[35]
- Make.text — букмарклет, преобразующий любую веб-страницу в Markdown^[36]
- XHTML-to-Markdown XSLT (XSLT-таблица стилей, работает только с XHTML)^[37]
- Pandoc — написанная на Haskell библиотека по преобразованию различных форматов, поддерживает несколько диалектов Markdown (markdown — диалект от pandoc, markdown_strict — оригинальный Markdown без расширений, markdown_phpextra — диалект от PHP, markdown_github — диалект от github) может преобразовывать из и в Markdown, HTML, reStructuredText, LaTeX, и другие.^[11]
Другие форматы в Markdown
- odt2txt (написанный на Python скрипт для преобразования файлов из формата OpenDocument в Markdown)^[38]
- word_markdown_macro (макрос Microsoft Word, преобразующий некоторую часть форматирования Word в Markdown)^[39]

Утилиты

Markdown tool (написанный на Python скрипт для загрузки документов Markdown вместе с изображениями)^[40]
Writage — плагин для Microsoft Word, позволяющий конвертировать DOCX документы в формат Markdown и наоборот.

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

Вики:
- DokuWiki (с помощью плагина)
- ikiwiki
- Oddmuse
- PmWiki (с помощью плагина)
Блоги:
- Tumblr — изначально отключён, но можно использовать, включив в настройках.
- scriptogr.am
CMS:
- Drupal — content-фильтр Markdown^[41]
- Magento — с помощью модуля^[42]
- Plone — «родная» поддержка в Plone 3
- TYPO3 — с помощью плагина af_markdown^[43]
- RadiantCMS — один из видов разметки, доступный «из коробки»^[44]
- HTMLy — по умолчанию используется для хранения контента (вместо баз данных)^[45]
Веб-фреймворки:
- Ruby on Rails — требуется установка BlueCloth, Maruku^[46]
- Yii — виджет CMarkdown, входит в стандартную поставку фреймворка
- Webasyst — входит в стандартную поставку PHP-фреймфорка в виде плагина к бесплатному приложению «Блог»
- Symfony — требуется установка бандла KnpMarkdownBundle
Социальные приложения:
- Discord — приложение для публичного общения.
- Steemit — социальная сеть, основанная на блокчейне.
- Telegram — популярный кросс-платформенный мессенджер.
- WhatsApp — популярный кросс-платформенный мессенджер.
- Element.io (бывший Riot.im) — защищённый кросс-платформенный мессенджер, работающий по федеративному протоколу Matrix.
Системы управления проектами и кодом:
- GitHub.
- GitLab.
- Jira.
- Redmine — по умолчанию использует Textile, язык разметки задаётся в настройках.
- Trello.

Поддержка текстовыми редакторами

Универсальные редакторы: TextMate, BBEdit (с версии 8.6), Vim (с помощью специального пользовательского режима^[47], написанного Беном Вильямсом), Emacs(с помощью специального пользовательского режима^[48], написанного Джейсоном Блевинсом), TextWrangler, Smultron, Sublime Text, Geany, Atom, Visual Studio Code.
Редакторы для блогов: Ecto^[49], MarsEdit
Плагины для редактора среды Eclipse от ThinkTank Mathematics^[50]
Плагины для текстового редактора gedit^[51]
Текстовый редактор iA Writer в версии для Mac OS^[52] и Android^[53].
Текстовый редактор Markor для Android^[54].
Текстовый редактор ReText для GNU/Linux^[55]
WYSIWYM-редактор Texts для Windows/Mac OS^[56]
WYSIWYM-редактор Typora для Windows, GNU/Linux и Mac OS ^[57]

Примечания

Шаблон:Примечания

Шаблон:Языки разметки документов

[1] Описание синтаксиса Markdown Шаблон:Wayback Шаблон:Ref-en

[2] Markdownsharp

[3] Шаблон:Cite web

[4] Шаблон:Cite web

[5] Шаблон:Cite web

[6] Шаблон:Cite web

[7] Шаблон:Cite web

[8] Шаблон:Cite web

[9] Шаблон:Cite web

[10] Шаблон:Cite web

[pandoc-11] 11,0 ^11,1 ^11,2 Шаблон:Cite web

[12] Шаблон:Cite web

[autogenerated1-13] 13,0 ^13,1 Шаблон:Cite web

[14] Шаблон:Cite web

[15] Шаблон:Cite web

[16] Шаблон:Cite web

[17] Шаблон:Cite web

[18] The Search Engine that Does at InfoWeb.net Шаблон:Недоступная ссылка

[19] Text::Markdown — search.cpan.org

[20] Шаблон:Cite web

[python-markdown-21] 21,0 ^21,1 Шаблон:Cite web

[py-markdown2-22] 22,0 ^22,1 Шаблон:Cite web

[23] BlueCloth Шаблон:Webarchive

[maruku-24] 24,0 ^24,1 Шаблон:Cite web

[25] Шаблон:Cite web

[26] The CAIUS project has a pure Tcl package for processing Markdown

[27] Шаблон:Cite web

[28] Text::MultiMarkdown — search.cpan.org

[29] Шаблон:Cite web

[30] Шаблон:Cite web

[31] rkdown от Pandoc против стандартного markdown Шаблон:Wayback Шаблон:Ref-en

[32] Шаблон:Cite web

[33] Шаблон:Cite web

[34] Шаблон:Cite web

[35] Шаблон:Cite web

[36] Make.text

[37] Шаблон:Cite web

[38] Markdown in Python: odt2txt Шаблон:Webarchive

[39] Шаблон:Cite web

[40] Шаблон:Cite web

[41] Шаблон:Cite web

[42] Шаблон:Cite web

[43] Шаблон:Cite web

[44] Шаблон:Cite web

[45] Шаблон:Cite web

[46] The Search Engine that Does at InfoWeb.net Шаблон:Webarchive или RDiscount Шаблон:Wayback, который является развитием BlueCloth

[47] Шаблон:Cite web

[48] Шаблон:Cite web

[49] Ecto, редактор для блогов Шаблон:Wayback Шаблон:Ref-en

[50] Markdown-плагин для редактора среды Eclipse Шаблон:Webarchive Шаблон:Ref-en

[51] Markdown-плагин для текстового редактора gedit Шаблон:Webarchive Шаблон:Ref-en

[52] A Writer для Mac Шаблон:Webarchive Шаблон:Ref-en

[53] Шаблон:Cite web

[54] Шаблон:Статья

[55] ReText — text editor for Markdown and reStructuredText Шаблон:Webarchive Шаблон:Ref-en

[56] Texts — rich editor for plain text Шаблон:Wayback Шаблон:Ref-en

[57] ttps://typora.io/ Шаблон:Wayback Typora — a markdown editor, markdown reader.

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

[14]

[15]

[16]

[17]

[18]

[19]

[20]

[21]

[22]

[23]

[24]

[25]

[26]

[27]

[28]

[29]

[30]

[31]

[32]

[33]

[34]

[35]

[36]

[37]

[38]

[39]

[40]

[41]

[42]

[43]

[44]

[45]

[46]

[47]

[48]

[49]

[50]

[51]

[52]

[53]

[54]

[55]

[56]

[57]

Партнерские ресурсы
Криптовалюты	Обмен криптовалют - www.bestchange.ru Криптовалютная биржа CoinEx Криптовалютная биржа Binance HIVE OS - операционная система для майнинга e4pool - Мультивалютный пул для майнинга.
Магазины	AliExpress — глобальная виртуальная (в Интернете) торговая площадка, предоставляющая возможность покупать товары производителей из КНР; computeruniverse.net - Интернет-магазин компьютеров(Промо код 5 Евро на первую покупку:FWWC3ZKQ);
Хостинг	DigitalOcean - американский провайдер облачных инфраструктур, с главным офисом в Нью-Йорке и с центрами обработки данных по всему миру;
Разное	Викиум - Онлайн-тренажер для мозга Like Центр - Центр поддержки и развития предпринимательства. Gamersbay - лучший магазин по бустингу для World of Warcraft. Ноотропы OmniMind N°1 - Усиливает мозговую активность. Повышает мотивацию. Улучшает память. Санкт-Петербургская школа телевидения - это федеральная сеть образовательных центров, которая имеет филиалы в 37 городах России. Lingualeo.com — интерактивный онлайн-сервис для изучения и практики английского языка в увлекательной игровой форме. Junyschool (Джунискул) – международная школа программирования и дизайна для детей и подростков от 5 до 17 лет, где ученики осваивают компьютерную грамотность, развивают алгоритмическое и креативное мышление, изучают основы программирования и компьютерной графики, создают собственные проекты: игры, сайты, программы, приложения, анимации, 3D-модели, монтируют видео. Умназия - Интерактивные онлайн-курсы и тренажеры для развития мышления детей 6-13 лет SkillBox - это один из лидеров российского рынка онлайн-образования. Среди партнеров Skillbox ведущий разработчик сервисного дизайна AIC, медиа-компания Yoola, первое и самое крупное русскоязычное аналитическое агентство Tagline, онлайн-школа дизайна и иллюстрации Bang! Bang! Education, оператор PR-рынка PACO, студия рисования Draw&Go, агентство performance-маркетинга Ingate, scrum-студия Sibirix, имидж-лаборатория Персона. «Нетология» — это университет по подготовке и дополнительному обучению специалистов в области интернет-маркетинга, управления проектами и продуктами, дизайна, Data Science и разработки. В рамках Нетологии студенты получают ценные теоретические знания от лучших экспертов Рунета, выполняют практические задания на отработку полученных навыков, общаются с экспертами и единомышленниками. Познакомиться со всеми продуктами подробнее можно на сайте https://netology.ru, линейка курсов и профессий постоянно обновляется. StudyBay Brazil – это онлайн биржа для португалоговорящих студентов и авторов! Студент получает уникальную работу любого уровня сложности и больше свободного времени, в то время как у автора появляется дополнительный заработок и бесценный опыт. Автор24 — самая большая в России площадка по написанию учебных работ: контрольные и курсовые работы, дипломы, рефераты, решение задач, отчеты по практике, а так же любой другой вид работы. Сервис сотрудничает с более 70 000 авторов. Более 1 000 000 работ уже выполнено. StudyBay – это онлайн биржа для англоязычных студентов и авторов! Студент получает уникальную работу любого уровня сложности и больше свободного времени, в то время как у автора появляется дополнительный заработок и бесценный опыт.