Порівняння та порівняння легких мов розмітки [закрито]

Будь ласка, визначте найпопулярніші легкі мови розмітки та порівняйте їх сильні та слабкі сторони. Ці мови повинні бути розміткою загального призначення для технічної прози, наприклад для документації (наприклад, Haml не враховується).

Див. Також: Маркдаун проти ReStructuredText

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

Текстильна

• Використовується Redmine та спільнотою Ruby
• На даний момент 113 запитань помічено на Stack Overflow
• Найбільш схоже на HTML, але найменш читабельне джерело
• Найпростіші вкладені списки всіх трьох мов
• Незрозуміле не програмістам або невігласам HTML
• Ідеально підходить для складних коротких документів (із посиланнями, вкладеними списками, кодом, користувацьким HTML); наприклад: коротка документація, інструкції, вміст блогу або системи управління вмістом
• Посилання на синтаксис

Націнка

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

reStructuredText (AKA ReST)

• Популярний у спільноті Python
• 285 запитань з тегами на Stack Overflow
• Якщо ви запитаєте мене, трохи проникливий щодо пробілів та вирівнювання
• Списки (особливо вкладені списки) та абзаци, здається, завжди потрапляють у сутички
• Читається непрограмістами
• Тільки формат, який може скласти зміст (за допомогою розширення в реалізації посилань на Python)
• Безпосередньо перетворює в інші формати, такі як PDF та XML
• Ідеально підходить для великих документів із великою кількістю прози (наприклад, альтернатива докбуку для посібника користувача)
• Посилання на синтаксис

Ви також можете розглянути 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

Поки що я пробував розмітку та ReST, і останні мені більше подобаються, окрім фрагментів HTML, вбудованих в інші сторінки. Таблиці, перехресні посилання, непрямі посилання тощо ...

для документації? як щодо кисню ?
Я використовую його для деяких проектів c / c ++, які мені потрібно документувати. Навіть ви можете "зловживати" нею так само, як автор кисню використовує для документації щодо кисню