documentation - 軽量マークアップ言語を比較対照する

Question

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

score 115 · Accepted Answer

私は、より大きなプログラミングおよび技術コミュニティで一般的に使用されている 3 つの主な言語を知っています。それは、Textile、Markdown、および reStructuredText です。3 つはすべて、数時間で習得できます。

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

score 21 · Accepted Answer

軽量マークアップ言語に関するウィキペディアのページには、さまざまなオプションの適切な比較と、一般的な使用法 (見出し、太字、斜体など) の構文が示されています。

score 5 · Accepted Answer

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

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

アップデート

Python 実装を使用した LWML のみに焦点を当てました。

これまでのところ、マークダウンと ReST を試してきましたが、他のページに埋め込まれた HTML スニペット以外は後者の方が気に入っています。表、相互参照、間接リンクなど...

score 4 · Accepted Answer

ドキュメンテーション用？doxygenはどうですか？
文書化する必要があるいくつかの c/c++ プロジェクトに使用しました。doxygenの作成者がdoxygenのドキュメントに使用するのと同じように、それを「悪用」することもできます

5 に答える 5