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

Ответ 1

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

Текстиль

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

Markdown

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

reStructuredText (A.K.A. ReST)

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

Ответ 2

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

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

Ответ 3

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

Ответ 4

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

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

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

Обновление

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

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

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

Ответ 5

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