web-dev-qa-db-ja.com

軽量マークアップ言語の比較と対照

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

参照： Markdown vs ReStructuredText

documentationmarkdownmarkuprestructuredtexttextile
90
JasonSmith

優れたプログラミングおよび技術コミュニティで一般的に使用される3つの主要な言語、Textile、Markdown、およびreStructuredTextを知っています。 3つすべてを数時間で習得するか、チートシートを近くに置いて「翼を広げ」ます。

繊維

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

マークダウン

  • 自国語の「コミュニティ」はないようですが...
  • Stack Overflow *でタグ付けされた1274の質問
  • 電子メールの伝統に似たソースコードの読みやすさを重視
  • 簡単なHTML埋め込み（タグを入力するだけです）
  • HTMLを埋め込む以外にテーブルを作成する方法はありません
  • スタックオーバーフローを知っていれば、あなたはすでにそれを知っています
  • ReStructuredTextを既に知っている場合は簡単に習得できます
  • 形式<[email protected]>の自動メールアドレス難読化（山括弧付き）
  • 構文リファレンス

reStructuredText（A.K.A. ReST）

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

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

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

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

21
technomalogical

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

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

ご覧のとおり、「安全なブログを作成する方法」、つまり静的なHTMLを生成する方法から始まり、マークアップ言語、テンプレートシステムなどに夢中になりました。

更新

python実装のLWMLのみに焦点を合わせました。

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

これまでのところ、markdownとReSTを試しましたが、他のページに埋め込まれたHTMLスニペット以外のものには後者がより適しています。テーブル、相互参照、間接リンクなど...

5
Travis H.

文書化のために？ doxygen ？
文書化する必要のあるc/c ++プロジェクトのいくつかに使用しました。 doxygenの作者がdoxygenのドキュメントに使用するように、「乱用」することもできます。

4
mhd