Markdown - вікіпедія перевидання

приклади синтаксису

Нижче наведені приклади використання 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-фреймфорка у вигляді плагіна до безкоштовного додатку «Блог»

Примітки

Схожі статті