приклади синтаксису
Нижче наведені приклади використання Markdown, однак це далеко не повне керівництво. Повний опис мови може бути знайдено на офіційному сайті [5]. Символи, які зазвичай розглядаються в Markdown як спеціальні, можуть бути екрановані за допомогою зворотного # 8197; слеша. Наприклад, послідовність «\ *» виведе символ «*», а не буде ознакою початку виділеного тексту. Крім того, Markdown НЕ перетворює текст всередині «сирих» блоків XHTML. Таким чином, в Markdown-документ можна включати секції XHTML, уклавши їх попередньо в теги рівня блоку.
- Текст з виділенням або логічним наголосом:
- Програмний код:
- Закреслений текст:
- списки:
- заголовки:
Створення заголовків проводиться шляхом приміщення знака # 8197; решітки перед текстом заголовка. Кількість знаків «#» відповідає рівню заголовка. HTML надає 6 рівнів заголовків.
Перші два рівні заголовка також мають альтернативний синтаксис:
і де-небудь в документі (наприклад в самому низу)
реалізації Markdown
розширення
Наведені нижче додатки реалізують Markdown, розширюючи його синтаксис додатковою функціональністю:
- MultiMarkdown (C) [28]
- Text :: MultiMarkdown (Perl) модуль, який реалізує розширення MultiMarkdown [29]
- PHP Markdown Extra [30]
- python-markdown2 (Підтримує деякі розширення PHP Markdown) [23]
- python-markdown (Має систему розширень для додавання нового синтаксису) [22]
- Markout (Java) [31]
- Pegdown (Java) [16]
- Maruku (Ruby) [25]
- Pandoc (Haskell) [14] [32]
керівництва
конвертери
- з HTML в Markdown
- html2text.py (написано на Python) [35]
- Markdownify (на PHP) [36]
- Make.text - букмарклет. перетворює будь-яку веб-сторінку в Markdown [37]
- XHTML-to-Markdown XSLT (XSLT-таблиця стилів, працює тільки з XHTML) [38]
- Pandoc - написана на Haskell бібліотека по перетворенню різних форматів, підтримує кілька діалектів Markdown (markdown - діалект від pandoc, markdown_strict - оригінальний Markdown без розширень, markdown_phpextra - діалект від PHP. Markdown_github - діалект від github) може перетворювати з і в Markdown, HTML. reStructuredText. LaTeX. та інші. [14]
- Інші формати в Markdown
- odt2txt (написаний на Python скрипт для перетворення файлів з формату OpenDocument в Markdown) [39]
- word_markdown_macro (макрос Microsoft # 8197; Word. перетворює деяку частину форматування Word в Markdown) [40]
Веб-додатки. використовують Markdown
- Вікі.
- DokuWiki (за допомогою плагіна)
- ikiwiki
- Oddmuse
- PmWiki (за допомогою плагіна)
- Блоги.
- Tumblr - спочатку відключений, але можна використовувати, включивши в настройках.
- scriptogr.am
- CMS.
- Drupal - content-фільтр Markdown [41]
- Magento - за допомогою модуля [42]
- Plone - «рідна» підтримка в Plone 3
- TYPO3 - за допомогою плагіна af_markdown [43]
- RadiantCMS - один з видів розмітки, доступний «з коробки» [44]
- Веб-фреймворки.
- Ruby # 8197; on # 8197; Rails - потрібна установка BlueCloth, Maruku [45]
- Yii - віджет CMarkdown, входить в стандартну поставку фреймворка
- Webasyst - входить в стандартну поставку PHP-фреймфорка у вигляді плагіна до безкоштовного додатку «Блог»