Markdown
Markdown | |
---|---|
![]() | |
![]() | |
Расширение | . |
MIME-тип | text/markdown[5] |
Разработчик | Аарон Шварц[6][7][…] и Джон Грубер[вд][7][8][…] |
Опубликован | 19 марта 2004; 20 лет назад (2004-03-19)[2][3] |
Последний выпуск | 17 декабря 2004; 19 лет назад (2004-12-17) |
Тип формата | Язык разметки |
Открытый формат? | да[4] |
Сайт | daringfireball.net/… (англ.) |
![]() |
Markdown (МФА: [ˈmɑːkdaʊn], произносится маркда́ун) — облегчённый язык разметки, созданный с целью обозначения форматирования в простом тексте, с максимальным сохранением его читаемости человеком, и пригодный для машинного преобразования в языки для продвинутых публикаций (HTML, Rich Text и других).
История
Первоначально создан в 2004 году Джоном Грубером[англ.] и Аароном Шварцем. Многие идеи языка были позаимствованы из существующих соглашений по разметке текста в электронных письмах. Реализации языка Markdown преобразуют текст в формате Markdown в валидный, правильно построенный XHTML и заменяют левые угловые скобки («<») и амперсанды («&») на соответствующие коды сущностей. Первой реализацией Markdown стала написанная Грубером реализация на Perl, однако спустя некоторое время появилось множество реализаций от сторонних разработчиков (см. ниже). Реализация на Perl распространяется по лицензии типа BSD. Реализации Markdown на различных языках программирования включены (или доступны в качестве плагина) во многие системы управления содержимым.
Примеры синтаксиса
Ниже приведены примеры использования Markdown, однако это далеко не полное руководство. Полное описание языка может быть найдено на официальном сайте[9]. Символы, которые обычно рассматриваются в 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
- C#[10][11]
- C[12][13][14][15]
- ColdFusion[16]
- Common Lisp[17]
- Go[18]
- Haskell[19]
- Java[20][21]
- JavaScript[22]
- Kotlin[23][24]
- Lua[25]
- newLISP[26]
- Perl[27]
- PHP[28]
- Python[29][30]
- Ruby[31][32]
- Scala[33]
- Tcl[34]
Расширения
Приведённые ниже приложения реализуют Markdown, расширяя его синтаксис дополнительной функциональностью:
- MultiMarkdown (C)[35]
- Text::MultiMarkdown (Perl) модуль, реализующий расширение MultiMarkdown[36]
- PHP Markdown Extra[37]
- python-markdown2 (Поддерживает некоторые расширения PHP Markdown)[30]
- python-markdown (Имеет систему расширений для добавления нового синтаксиса)[29]
- Markout (Java)[38]
- Pegdown (Java)[21]
- Maruku (Ruby)[32]
- Pandoc (Haskell)[19][39]
Руководства
- Markdown: Dingus онлайн-конвертер[40]
- Markdown cheat sheet[41]
Конвертеры
- из HTML в Markdown
- html2text.py (написано на Python)[42]
- Markdownify (на PHP)[43]
- Make.text — букмарклет, преобразующий любую веб-страницу в Markdown[44]
- XHTML-to-Markdown XSLT (XSLT-таблица стилей, работает только с XHTML)[45]
- Pandoc — написанная на Haskell библиотека по преобразованию различных форматов, поддерживает несколько диалектов Markdown (
markdown
— диалект от pandoc,markdown_strict
— оригинальный Markdown без расширений,markdown_phpextra
— диалект от PHP,markdown_github
— диалект от github) может преобразовывать из и в Markdown, HTML, reStructuredText, LaTeX, и другие[19].
- Другие форматы в Markdown
- odt2txt (написанный на Python скрипт для преобразования файлов из формата OpenDocument в Markdown)[46]
- word_markdown_macro (макрос Microsoft Word, преобразующий некоторую часть форматирования Word в Markdown)[47]
Утилиты
- Markdown tool (написанный на Python скрипт для загрузки документов Markdown вместе с изображениями)[48]
- Writage — плагин для Microsoft Word, позволяющий конвертировать DOCX документы в формат Markdown и наоборот.
Веб-приложения, использующие Markdown
- Вики:
- Блоги:
- Tumblr — изначально отключён, но можно использовать, включив в настройках.
- scriptogr.am
- CMS:
- Веб-фреймворки:
- Ruby on Rails — требуется установка BlueCloth, Maruku[54]
- Yii — виджет CMarkdown, входит в стандартную поставку фреймворка
- Webasyst — входит в стандартную поставку PHP-фреймфорка в виде плагина к бесплатному приложению «Блог»
- Symfony — требуется установка бандла KnpMarkdownBundle
- Социальные приложения:
- Discord — приложение для публичного общения.
- Steemit — социальная сеть, основанная на блокчейне.
- Telegram — популярный кросс-платформенный мессенджер.
- WhatsApp — популярный кросс-платформенный мессенджер.
- Element.io (бывший Riot.im) — защищённый кросс-платформенный мессенджер, работающий по федеративному протоколу Matrix.
- Системы управления проектами и кодом:
Поддержка текстовыми редакторами
- Универсальные редакторы: TextMate, BBEdit (с версии 8.6), Vim (с помощью специального пользовательского режима[55], написанного Беном Вильямсом), Emacs (с помощью специального пользовательского режима[56], написанного Джейсоном Блевинсом), TextWrangler, Smultron, Sublime Text, Geany, Atom, Visual Studio Code.
- Редакторы для блогов: Ecto[57], MarsEdit
- Плагины для редактора среды Eclipse от ThinkTank Mathematics[58]
- Плагины для текстового редактора gedit[59]
- Текстовый редактор iA Writer в версии для Mac OS[60] и Android[61].
- Текстовый редактор Markor для Android[62].
- Текстовый редактор ReText для GNU/Linux[63]
- WYSIWYM-редактор Texts для Windows/Mac OS[64]
- WYSIWYM-редактор Typora для Windows, GNU/Linux и Mac OS[65]
Примечания
- ↑ The Markdown File Extension (англ.) (1 августа 2014). Дата обращения: 16 июля 2020. Архивировано 12 июля 2020 года.
- ↑ Markdown (англ.). Aaron Swartz: The Weblog (19 марта 2004). Дата обращения: 16 июля 2020. Архивировано 25 декабря 2019 года.
- ↑ Daring Fireball: Markdown (неопр.). Дата обращения: 16 июля 2020. Архивировано 15 июля 2020 года.
- ↑ Markdown: License (неопр.). Daring Fireball. Дата обращения: 16 июля 2020. Архивировано 17 июня 2020 года.
- ↑ Leonard S. The text/markdown Media Type (англ.) — IETF, 2016. — 15 p. — doi:10.17487/RFC7763
- ↑ https://web.archive.org/web/20190727122847/http://www.aaronsw.com/weblog/001189
- ↑ 1 2 https://web.archive.org/web/20040402182332/http://daringfireball.net/projects/markdown/
- ↑ http://www.aaronsw.com/weblog/001189
- ↑ Описание синтаксиса Markdown Архивная копия от 22 февраля 2011 на Wayback Machine (англ.)
- ↑ Markdownsharp
- ↑ Knagis CommonMark.NET (неопр.). Дата обращения: 4 июля 2018. Архивировано 11 июня 2018 года.
- ↑ Discount — a C implementation of the Markdown markup language (неопр.). Дата обращения: 29 мая 2008. Архивировано 4 июня 2008 года.
- ↑ Standards compliant, fast, secure markdown processing library in C (неопр.). Дата обращения: 8 апреля 2015. Архивировано 1 августа 2015 года.
- ↑ An implementation of markdown in C, using a PEG grammar (неопр.). Дата обращения: 8 апреля 2015. Архивировано 23 марта 2015 года.
- ↑ Flexible C library for markdown parsing (неопр.). Дата обращения: 9 апреля 2015. Архивировано 20 мая 2018 года.
- ↑ CFX_Markdown | Seb Duggan (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 23 ноября 2008 года.
- ↑ CL-Markdown — Markdown and More (неопр.). Дата обращения: 29 мая 2008. Архивировано 16 мая 2008 года.
- ↑ Blackfriday: a markdown processor for Go (неопр.). Дата обращения: 15 октября 2013. Архивировано 20 июня 2014 года.
- ↑ 1 2 3 Pandoc — About pandoc (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 26 августа 2007 года.
- ↑ myabc/markdownj (неопр.). GitHub. Дата обращения: 28 января 2016. Архивировано 17 февраля 2016 года.
- ↑ 1 2 dokka - - Kotlin Resources (неопр.). Дата обращения: 29 ноября 2017. Архивировано из оригинала 1 декабря 2017 года.
- ↑ Showdown — A JavaScript port of Markdown (неопр.). Дата обращения: 10 августа 2012. Архивировано 21 августа 2013 года.
- ↑ intellij-markdown (неопр.). GitHub. Дата обращения: 29 ноября 2017. Архивировано 11 июня 2018 года.
- ↑ Documentation Engine for Kotlin (неопр.). Дата обращения: 11 августа 2010. Архивировано 22 июня 2013 года.
- ↑ TITLE (неопр.). Дата обращения: 29 мая 2008. Архивировано 16 мая 2008 года.
- ↑ The Search Engine that Does at InfoWeb.net (недоступная ссылка)
- ↑ Text::Markdown — search.cpan.org
- ↑ PHP Markdown (неопр.). Дата обращения: 29 мая 2008. Архивировано 2 июня 2008 года.
- ↑ 1 2 Markdown in Python: Overview (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 24 мая 2008 года.
- ↑ 1 2 python-markdown2 — Project Hosting on Google Code (неопр.). Дата обращения: 17 мая 2018. Архивировано 11 июня 2018 года.
- ↑ BlueCloth Архивировано 13 июня 2008 года.
- ↑ 1 2 Maruku: a Markdown-superset interpreter (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 20 июня 2008 года.
- ↑ MarkWrap — Unified Scala wrapper API for various lightweight markup APIs (неопр.). Дата обращения: 5 сентября 2011. Архивировано 27 августа 2011 года.
- ↑ The CAIUS project has a pure Tcl package for processing Markdown
- ↑ MultiMarkdown (неопр.). Дата обращения: 9 сентября 2012. Архивировано 4 июля 2013 года.
- ↑ Text::MultiMarkdown — search.cpan.org
- ↑ PHP Markdown Extra (неопр.). Дата обращения: 29 мая 2008. Архивировано 22 мая 2008 года.
- ↑ Markout: Markout (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 23 февраля 2008 года.
- ↑ markdown от Pandoc против стандартного markdown Архивная копия от 12 мая 2014 на Wayback Machine (англ.)
- ↑ Daring Fireball: Markdown Web Dingus (неопр.). Дата обращения: 29 мая 2008. Архивировано 12 июня 2008 года.
- ↑ warpedvisions.org :: Markdown cheat sheet (неопр.). Дата обращения: 13 октября 2013. Архивировано 12 октября 2013 года.
- ↑ html2text: THE ASCIINATOR (aka html2txt) (неопр.). Дата обращения: 29 мая 2008. Архивировано 9 мая 2008 года.
- ↑ Markdownify: The HTML to Markdown converter for PHP (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 5 июня 2008 года.
- ↑ Make.text
- ↑ Elements or Lower :: Geekery : XML : XHTML-to-Markdown.html (неопр.). Дата обращения: 29 мая 2008. Архивировано 4 июня 2008 года.
- ↑ Markdown in Python: odt2txt Архивировано 24 мая 2008 года.
- ↑ ProgTips " Blog Archive " Word to Markdown converter (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 27 марта 2008 года.
- ↑ Markdown tool (неопр.). Дата обращения: 11 июля 2021. Архивировано 1 апреля 2021 года.
- ↑ Markdown filter for Drupal | drupal.org (неопр.). Дата обращения: 18 ноября 2010. Архивировано 25 сентября 2010 года.
- ↑ Модуль «Редактор Markdown» для Magento (неопр.). Дата обращения: 8 ноября 2015. Архивировано 4 марта 2016 года.
- ↑ typo3.org: Repository (неопр.). Дата обращения: 29 мая 2008. Архивировано из оригинала 17 ноября 2006 года.
- ↑ RadiantCMS (неопр.). Дата обращения: 2 марта 2021. Архивировано из оригинала 4 июня 2006 года.
- ↑ HTMLy (неопр.). Дата обращения: 19 сентября 2018. Архивировано 19 сентября 2018 года.
- ↑ The Search Engine that Does at InfoWeb.net Архивировано 8 сентября 2008 года. или RDiscount Архивная копия от 27 августа 2010 на Wayback Machine, который является развитием BlueCloth
- ↑ Markdown Vim Mode | PlasticBoy (неопр.). Дата обращения: 24 ноября 2015. Архивировано 14 января 2016 года.
- ↑ Emacs Markdown Mode (неопр.). Дата обращения: 24 ноября 2015. Архивировано 30 ноября 2015 года.
- ↑ Ecto, редактор для блогов Архивная копия от 18 сентября 2009 на Wayback Machine (англ.)
- ↑ Markdown-плагин для редактора среды Eclipse Архивировано 31 декабря 2009 года. (англ.)
- ↑ Markdown-плагин для текстового редактора gedit Архивировано 13 сентября 2009 года. (англ.)
- ↑ iA Writer для Mac Архивировано 12 января 2012 года. (англ.)
- ↑ Приложения в Google Play – iA Writer: Get Focused. (рус.) play.google.com. Дата обращения: 18 ноября 2018. Архивировано 8 апреля 2019 года.
- ↑ Gregor Santner. Markor. — 2022-07-04. Архивировано 5 июля 2022 года.
- ↑ ReText — text editor for Markdown and reStructuredText Архивировано 11 ноября 2012 года. (англ.)
- ↑ Texts — rich editor for plain text Архивная копия от 14 октября 2012 на Wayback Machine (англ.)
- ↑ https://typora.io/ Архивная копия от 11 марта 2020 на Wayback Machine Typora — a markdown editor, markdown reader.