Сравните и сопоставьте облегченные языки разметки [закрыто]

Определите самые популярные облегченные языки разметки и сравните их сильные и слабые стороны. Эти языки должны быть универсальной разметкой для технической прозы, например, для документации (например, Haml не в счет).

См. Также: Markdown против ReStructuredText

Я знаю три основных языка, обычно используемых в большом сообществе разработчиков и технических специалистов: Textile, Markdown и reStructuredText. Все три можно выучить за пару часов или «крылатить» с помощью шпаргалки рядом.

Текстиль

• Используется Redmine и сообществом Ruby
• 113 вопросов, отмеченных в настоящее время на Stack Overflow
• Наиболее похож на HTML, но наименее читаемый источник
• Самые простые вложенные списки всех трех языков
• Непонятно для непрограммистов или не знающих HTML
• Идеально подходит для сложных коротких документов (со ссылками, вложенными списками, кодом, настраиваемым HTML); например: краткая документация, инструкции, блог или контент CMS.
• Справочник по синтаксису

Markdown

• Кажется, нет "сообщества" на родном языке, но ...
• 1274 вопроса с тегом Stack Overflow *
• Подчеркивает читаемость исходного кода, аналогично традициям электронной почты
• Простое встраивание HTML (вы просто вводите теги)
• Нет возможности создавать таблицы, кроме встраивания HTML
• Вы это уже знаете, если знаете Stack Overflow
• Легко изучить, если вы уже знаете reStructuredText
• Автоматическое обфускация адресов электронной почты для формата <address@example.com> (с угловыми скобками)
• Справочник по синтаксису

reStructuredText (AKA ReST)

• Популярно в сообществе Python
• 285 вопросов с тегом Stack Overflow
• Немного привередливо насчет пробелов и выравнивания, если вы спросите меня
• Списки (особенно вложенные списки) и абзацы всегда становятся предметом споров.
• Читается непрограммистами
• Только формат, который может создавать оглавление (через расширение в эталонной реализации Python)
• Непосредственно конвертирует в другие форматы, такие как PDF и XML
• Идеально подходит для больших документов с большим количеством прозы (например, альтернатива docbook для руководства пользователя)
• Справочник по синтаксису

Вы также можете рассмотреть asciidoc

• относительно читаемая разметка
• простое использование командной строки
• некоторые могут посчитать это относительно «придирчивым» (а не гибким) в отношении синтаксиса
• docbook и вывод (x) html

На странице Википедии, посвященной облегченным языкам разметки, есть хорошее сравнение между различными вариантами, а также показан синтаксис для общего использования (заголовки, жирный шрифт, курсив и т. Д.)

Я пытаюсь охватить здесь все различные облегченные языки разметки:

http://www.subspacefield.org/~travis/static_blog_generators.html

Как видите, все началось с того, «как я могу создать безопасный блог» - то есть того, который генерирует статический HTML, и я оказался в ловушке языков разметки, систем шаблонов и т. Д.

Обновить

Я перефокусировался только на LWML с реализациями python, и они здесь:

http://www.subspacefield.org/~travis/python_lightweight_markup_languages.html

До сих пор я пробовал markdown и ReST, и последний мне нравится больше всего, кроме HTML-фрагментов, встроенных в другие страницы. Таблицы, перекрестные ссылки, косвенные ссылки и т. Д.

для документации? как насчет доксигена ?
Я использую его для некоторых проектов c / c ++, которые мне нужно документировать. Даже вы можете злоупотреблять им, как автор doxygen использует для документации doxygen