軽量マークアップ言語を比較対照する[終了]

最も人気のある軽量マークアップ言語を特定し、それらの長所と短所を比較してください。これらの言語は、ドキュメンテーションなどの技術的な散文の汎用マークアップである必要があります（たとえば、Hamlはカウントされません）。

参照：MarkdownとReStructuredText

私は、より大きなプログラミングおよび技術コミュニティで一般的に使用されている3つの主要言語、Textile、Markdown、およびreStructuredTextを知っています。3つすべては、数時間で学習することも、チートシートを近くに置いて「羽ばたく」こともできます。

繊維

• RedmineとRubyコミュニティが使用
• 現在Stack Overflowでタグ付けされている113の質問
• HTMLに最もよく似ていますが、最も読みにくいソース
• 3つの言語すべての最も簡単なネストされたリスト
• 非プログラマーやHTMLを知らない人には理解できない
• 複雑な短いドキュメントに最適（リンク、ネストされたリスト、コード、カスタムHTML）。例：短いドキュメント、ハウツー、ブログ、CMSコンテンツ
• 構文リファレンス

マークダウン

• 母国語の「コミュニティ」はないようですが...
• Stack Overflowでタグ付けされた1274質問*
• 電子メールの伝統と同様に、ソースコードの読みやすさを強調
• 簡単なHTML埋め込み（タグを入力するだけ）
• HTMLの埋め込み以外にテーブルを作成する方法はありません
• スタックオーバーフローを知っていれば、すでにわかっています。
• reStructuredTextをすでに知っていれば、簡単に習得できます
• <address@example.com>形式の自動メールアドレス難読化（山かっこ付き）
• 構文リファレンス

reStructuredText（別名ReST）

• Pythonコミュニティで人気
• Stack Overflowでタグ付けされた285の質問
• あなたが私に尋ねるなら、空白と配置について少し忍耐強く
• リスト（特にネストされたリスト）と段落は常に争いになっているようです
• プログラマーでない人も読める
• 目次を作成できる唯一の形式（Pythonリファレンス実装の拡張機能を使用）
• PDFやXMLなどの他の形式に直接変換します
• 散文が多い大きなドキュメントに最適です（たとえば、ユーザーマニュアル用のdocbookの代替）
• 構文リファレンス

asciidocを検討することもできます

• 比較的読みやすいマークアップ
• 簡単なコマンドラインの使用
• 一部の人は、構文に関してそれを比較的「ピッキー」（対柔軟）であると認識するかもしれません
• docbookおよび（x）html出力

軽量マークアップ言語のWikipediaページでは、さまざまなオプションを比較し、一般的な使用法（見出し、太字、斜体など）の構文を示しています。

ここでは、さまざまな軽量マークアップ言語をすべてカバーしようとしています。

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

ご覧のとおり、「安全なブログを作成するにはどうすればよいですか」、つまり静的なHTMLを生成するブログから始まり、マークアップ言語やテンプレートシステムなどに夢中になっていることに気づきました。

更新

私はPython実装のLWMLのみに再び焦点を合わせました、そして彼らはここにいます：

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

これまでのところ、マークダウンとReSTを試しましたが、他のページに埋め込まれたHTMLスニペット以外には、後者のほうが好きです。テーブル、相互参照、間接リンクなど...

ドキュメンテーションのため？方法についてはdoxygenを？
ドキュメント化する必要がある一部のc / c ++プロジェクトで使用しました。doxygen作者がdoxygenのドキュメントに使用するのと同じように、「乱用」することもできます