軽量マークアップ言語

シンプルで目立たない構文のマークアップ言語

軽量マークアップ言語LML)は、シンプルマークアップ言語またはヒューメインマークアップ言語とも呼ばれ、シンプルで控えめな構文を持つマークアップ言語です。一般的なテキストエディタを使用して簡単に記述でき、そのままの形式でも読みやすいように設計されています。軽量マークアップ言語は、最終的なレンダリング出力だけでなく、生の文書も読み取る必要があるアプリケーションで使用されます

例えば、ソフトウェアライブラリをダウンロードする人は、ドキュメントをウェブブラウザではなくテキストエディタで読みたいと思うかもしれません。このような言語のもう一つの用途は、ブログWikiといったウェブベースの出版におけるデータ入力です。これらの入力インターフェースはシンプルなテキストボックスです。サーバーソフトウェアは入力されたデータをHTMLなどの一般的なドキュメントマークアップ言語に変換します

歴史

軽量マークアップ言語はもともと、文字を斜体太字で表示できないテキストのみのディスプレイで使用されていたため、この情報を伝達するための非公式な方法を開発する必要がありました。この書式設定の選択は、当然のことながら、プレーンテキストの電子メール通信にも引き継がれました。コンソールブラウザでも同様の表示規則が使用される場合があります

1986年に制定された国際標準SGMLは、文法とタグの含意を用いて軽量マークアップ言語を定義および解析する機能を提供しました。1998年のW3C XMLは、これらの機能を省略したSGMLのプロファイルです。しかしながら、以下に挙げる言語のいずれについても、SGML文書型定義(DTD)は知られていません。

種類

軽量マークアップ言語は、タグの種類によって分類できます。HTML()と同様に、一部の言語では開始タグと終了タグに共通の形式を持つ名前付き要素を使用します(例:BBCode)。一方、本格的な軽量マークアップ言語では、タグにASCIIのみの句読点とその他の文字以外の記号しか使用できません。また、両方のスタイルを混在させる言語(例:Textile)や、埋め込みHTML(例:Markdown)を許可する言語もあり、カスタム要素で拡張することも可能です(例:MediaWiki)。 <b>bold</b> [b]bold[/b] bq. <ref>'''source'''</ref>

ほとんどの言語では、行またはブロックのマークアップと、短いテキスト範囲のマークアップを区別しますが、インライン マークアップのみをサポートする言語もあります。

マークアップ言語の中には、コンピュータコードの文書化(例:PODreSTRD)や特定の出力形式(通常はHTMLまたはLaTeX)への変換など、特定の目的に特化したものがありますが、より汎用的な用途を持つものもあります。これには、テキスト表示を重視するか、データのシリアル化を重視するかが含まれます。[説明が必要]

プレゼンテーション指向の言語には、AsciiDocatxBBCodeCreole、 Crossmark 、 Djot 、 Epytext 、HamlJsonMLMakeDocMarkdownOrg-modePOD (Perl)reST (Python)RD (Ruby)SetextSiSUSPIP、 Xupl 、Texy!、 Textile 、txt2tagsUDOWikitextなどがあります。

データシリアル化指向の言語には、Curl (同形言語ですが JSON も読み取り、すべてのオブジェクトがシリアル化されます)、JSONYAMLなどがあります。

言語機能の比較

言語機能の比較
言語 HTMLエクスポートツール HTMLインポートツール リンクタイトル class属性 id属性 リリース日
AsciiDoc はい はい はい はい はい はい 2002年11月25日[1]
BBコード いいえ いいえ はい いいえ いいえ いいえ 1998
クレオール いいえ いいえ はい いいえ いいえ いいえ 2007年7月4日[2]
Djot はい はい[3] はい はい はい はい 2022年7月30日[4]
DokuWiki はい はい/いいえ はい はい はい/いいえ はい/いいえ 2004年7月4日[5]
Gemtext はい いいえ はい いいえ いいえ 2020
GitHub Flavored Markdown はい いいえ はい はい いいえ いいえ 2011年4月28日以降
Jira フォーマット表記 はい いいえ はい はい いいえ いいえ 2002+ [6]
マークダウン はい はい いいえ はい はい/いいえ はい/いいえ 2004年3月19日[7] [8]
Markdown Extra はい はい はい[9] はい はい はい 2013年4月11日[10]
メディアウィキ はい はい はい はい はい はい 2002 [11]
マルチマークダウン はい いいえ はい はい いいえ いいえ 2009年7月13日
オルグモード はい はい[12] はい はい はい はい 2003 [13]
PmWiki はい[14] はい はい はい はい はい 2002-01
POD はい いいえ はい 1994
reStructuredText はい はい[12] はい はい はい 自動 2002年4月2日[15]
シーテキスト はい はい いいえ はい いいえ いいえ 1992 [16]
スラック いいえ いいえ いいえ はい いいえ いいえ 2013+ [17] [18]
テキスタイル はい いいえ はい はい はい はい 2002年12月26日[19]
Texy はい はい はい はい はい はい 2004年[20]
ティドリーウィキ はい いいえ はい はい はい いいえ 2004-09 [21]
txt2tags はい はい[22] はい[23] はい はい/いいえ はい/いいえ 2001年7月26日[24]
WhatsApp いいえ いいえ いいえ いいえ いいえ いいえ 2016-03-16 [25]

Markdownの構文はclass属性やid属性をサポートしていません。しかし、MarkdownはネイティブHTMLコードの組み込みをサポートしているため、これらの機能は直接HTMLを使用して実装できます。(一部の拡張機能はこれらの機能をサポートしている場合があります。)

txt2tagsの独自の構文はクラス属性やID属性をサポートしていません。しかし、txt2tagsはタグ付き領域にネイティブHTMLコードを含めることをサポートしているため、HTMLターゲットに保存するときに直接HTMLを使用してこれらの機能を実装できます。[26]

DokuWikiはHTMLのインポートをネイティブにサポートしていませんが、HTMLからDokuWikiへのコンバーターとインポーターが存在し、公式ドキュメントに記載されています。[27] DokuWikiはclass属性やid属性をサポートしていませんが、HTMLコードをサポートするように設定することができ、両方の機能をサポートしています。HTMLコードのサポートは、リリース2023-04-04より前に組み込まれていました。[28]それ以降のバージョンでは、プラグインを通じてHTMLコードのサポートを実現できますが、推奨されていません。[28]

実装機能の比較

実装の比較、特に出力形式
言語 実装 X HTML Con / LaTeX PDF DocBook ODF EPUB DOC (X) LML その他 ライセンス
AsciiDoc PythonRubyJavaScriptJava XHTML LaTeX PDF DocBook ODF EPUB いいえ 該当なし マニュアルページなど GNU GPL、MIT
BBコード PerlPHPC#PythonRuby (X)HTML いいえ いいえ いいえ いいえ いいえ いいえ 該当なし 該当なし パブリックドメイン
クレオール PHPPythonRubyJavaScript [29] 実装に依存 CC_BY-SA 1.0
Djot Lua(オリジナル)、JavaScriptPHPPrologRust [3] HTML LaTeX、ConTeXt PDF DocBook ODF EPUB RTF MediaWiki、reST マニュアルページ、S5など MIT
GitHub Flavored Markdown Haskell ( Pandoc ) HTML LaTeX、ConTeXt PDF DocBook ODF EPUB DOC AsciiDocreST OPML GPL
Java[30] JavaScript[31] [32] [33] PHP[34] [35] Python[36] Ruby [37] HTML [31] [32] [33] [35] [36] いいえ いいえ いいえ いいえ いいえ いいえ 該当なし 該当なし 独自
マークダウン Perl(オリジナル)、C[38] [39] Python[40] JavaScriptHaskell[12] Ruby[41] C#JavaPHP HTML LaTeX、ConTeXt PDF DocBook ODF EPUB RTF MediaWikireST マニュアルページS5など BSDスタイルとGPL(両方)
Markdown Extra PHP(オリジナル)、PythonRuby XHTML いいえ いいえ いいえ いいえ いいえ いいえ 該当なし 該当なし BSDスタイルとGPL(両方)
メディアウィキ PerlPHPHaskellPython XHTML いいえ いいえ いいえ いいえ いいえ いいえ 該当なし 該当なし GNU GPL
マルチマークダウン CPerl (X)HTML LaTeX PDF いいえ ODF いいえ DOC、RTF 該当なし OPML GPLMIT
オルグモード Emacs LispRuby(パーサーのみ)、PerlOCaml XHTML LaTeX PDF DocBook ODF EPUB [42] DOCX [42] マークダウン TXTXOXOiCalendarTexinfoman、contrib: groffs5、deck.js、Confluence Wikiマークアップ、[43] TaskJugglerRSSFreeMind GPL
PmWiki PHP XHTML 1.0 Transitional、HTML5 いいえ PDFエクスポートアドオン いいえ いいえ EPUBエクスポートアドオン いいえ 該当なし 該当なし GNU GPL
POD Perl (X)HTML、XML LaTeX PDF DocBook いいえ いいえ RTF 該当なし マニュアルページプレーンテキスト Artistic License、Perlのライセンス
reStructuredText Python[44] [45] Haskell (Pandoc)Java HTML、XML LaTeX PDF DocBook ODF EPUB DOC 該当なし manS5DevhelpQTヘルプCHMJSON パブリックドメイン
テキスタイル PHPJavaScriptJavaPerlPythonRubyASPC#Haskell XHTML いいえ いいえ いいえ いいえ いいえ いいえ 該当なし 該当なし テキスタイルライセンス
セクシー! PHPC#Java [a] (X)HTML いいえ いいえ いいえ いいえ いいえ いいえ 該当なし 該当なし GNU GPL v2ライセンス
txt2tags Python[46]、 PHP [47] (X)HTML、SGML LaTeX PDF DocBook ODF EPUB DOC CreoleAsciiDocMediaWikiMoinMoinPmWikiDokuWikiGoogle Code Wiki roffmanMagicPoint、 Lout 、PageMakerASCII アートTXT GPL

軽量マークアップ言語構文の比較

インラインspan構文

通常は斜体や太字のテキストを生成すると記載されていますが、軽量マークアッププロセッサの多くはセマンティックHTML要素を出力します。等幅テキストは、セマンティック要素またはプレゼンテーション要素のいずれかになりますem。Textileように区別している言語や、Texyのようにユーザーが簡単に出力を設定できる言語はほとんどありません。 strongcodett

LMLは複数単語のマークアップにおいて、単語間のスペース(中置)をマークアップ文字で置き換える必要がある場合があり、言語によって異なる場合があります。接頭辞と接尾辞として1文字のみを必要とする言語もあれば、2文字、あるいは3文字を必要とする言語もあります。また、強調レベルの違いなど、意味がわずかに異なる両方をサポートする言語もあります。

テキスト書式設定構文の比較
HTML出力 <strong>strongly emphasized</strong> <em>emphasized text</em> <code>code</code> セマンティック
<b>bold text</b> <i>italic text</i> <tt>monospace text</tt> プレゼンテーション
AsciiDoc *bold text* _italic text_ `monospace text` 演算子を 2 つ使用して、単語境界がない場所に書式を適用できます (たとえば、b old t ex**b**old t**ex**t tになります)。
'italic text'[b] +monospace text+[b]
BBコード [b]bold text[/b] [i]italic text[/i] [code]monospace text[/code] 書式設定は改行を越えて機能します。
クレオール **bold text** //italic text// {{{monospace text}}} 三重中括弧は、オプションで等幅フォントとなるnowikiを表します。
Djot *bold text* _italic text_ `monospace text`
DokuWiki **bold text** //italic text// <code>code</code>
''monospace text''
Gemtext 該当なし 該当なし ```alt text
monospace text
```
最初の 3 つのバッククォートの直後のテキストは alt テキストです。
Jira フォーマット表記 *bold text* _italic text_ {{monospace text}}
Markdown [48] **bold text** *italic text* `monospace text` セマンティック HTML タグ
__bold text__ _italic text_
メディアウィキ '''bold text''' ''italic text'' <code>monospace text</code> 主にインラインHTMLを使用しています
オルグモード *bold text* /italic text/ =code=
~verbatim~
PmWiki '''bold text''' ''italic text'' @@monospace text@@
POD B<bold text> I<italic text> C<monospace text> インデントされたテキストも等幅コードとして表示されます。
reStructuredText **bold text** *italic text* ``monospace text``
Setext **bold text** ~italic text~ `monospace text`
スラック *bold text* _italic text_ `monospace text` ```block of monospaced text```
テキスタイル[49] *strong* _emphasis_ @monospace text@ セマンティック HTML タグ
**bold text** __italic text__ プレゼンテーションHTMLタグ
セクシー! **bold text** *italic text* `monospace text` デフォルトでセマンティックHTMLタグ、プレゼンテーションタグはオプションでサポート
//italic text//
ティドリーウィキ ''bold text'' //italic text// `monospace text`
``monospace text``
txt2tags **bold text** //italic text// ``monospace text``
WhatsApp *bold text* _italic text_ ```monospace text```

Gemtextにはインライン書式設定がありません。等幅テキスト(Gemtextの文脈では整形済みテキストと呼ばれます)には、開始と終了が```それぞれ別の行に なければなりません

強調構文

HTMLでは、テキストは要素タイプ<em><strong>要素タイプで強調されますが、伝統的に<i>、とでは<b>それぞれテキストを斜体または太字にマークアップします

Microsoft WordとOutlook、そして同様のユーザーエクスペリエンスを目指す他のワードプロセッサやメールクライアントは、太字にはアスタリスク、斜体にはアンダースコアを使用するという基本的な慣例をサポートしています。Wordではこれらの文字は削除されますが、Outlookでは保持されます。

斜体または通常の強調
コード
AsciiDoc
ATX
クレオール語、
DokuWiki
ジラ
マークダウン
メディアウィキ
オルグモード
PmWiki
reST
Setext
スラック
テキスタイル
セクシー!
ティドリーウィキ
txt2tags
WhatsApp
*italic* いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ はい いいえ いいえ いいえ はい いいえ いいえ いいえ
**italic** いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
_italic_ はい はい いいえ はい はい いいえ いいえ いいえ いいえ いいえ はい はい いいえ いいえ いいえ はい
__italic__ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ
'italic' はい/いいえ[b] いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
''italic'' はい/いいえ[b] いいえ いいえ いいえ いいえ はい いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
/italic/ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
//italic// いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい はい はい いいえ
~italic~ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
太字または強い強調
コード
AsciiDoc
ATX
クレオール語、
DokuWiki
ジラ
マークダウン
メディアウィキ
オルグモード
PmWiki
reST
Setext
スラック
テキスタイル
セクシー!
ティドリーウィキ
txt2tags
WhatsApp
*bold* はい はい いいえ はい いいえ いいえ はい いいえ いいえ いいえ はい はい いいえ いいえ いいえ はい
**bold** はい いいえ はい いいえ はい いいえ いいえ いいえ はい はい いいえ はい はい いいえ はい いいえ
__bold__ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
''bold'' いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ
'''bold''' いいえ いいえ いいえ いいえ いいえ はい いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ

編集構文

HTMLでは、削除または挿入されたテキストはそれぞれ要素タイプと要素タイプでマークアップされます<del><ins>ただし、取り消し線や下線が引かれたテキスト範囲には、従来の要素タイプ<s>または<strike><u>も引き続き使用できます

下線付きまたは挿入されたテキスト
言語
コード
DokuWiki ジラ マークダウン オルグモード Setext セクシー! ティドリーウィキ txt2tags
_underline_ いいえ いいえ 任意 はい はい いいえ いいえ いいえ
__underline__ はい いいえ 任意 いいえ いいえ いいえ はい はい
+underline+ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
++underline++ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ

+inserted+AsciiDoc、ATX、Creole、MediaWiki、PmWiki、reST、Slack、Textile、WhatsAppは、テキストに下線を引くための専用のマークアップをサポートしていません。ただし、Textileは構文 による挿入をサポートしています

取り消し線または削除されたテキスト
言語
コード
ジラ マークダウン オルグモード スラック テキスタイル Texy ティドリーウィキ txt2tags WhatsApp
~stricken~ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ はい
~~stricken~~ いいえ GFM いいえ いいえ いいえ いいえ はい いいえ いいえ
+stricken+ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ
-stricken- はい いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ
--stricken-- いいえ いいえ いいえ いいえ いいえ はい いいえ はい いいえ

ATX、クレオール、MediaWiki、PmWiki、reST、Setextは、テキストに取り消し線を引くための専用マークアップをサポートしていません

DokuWiki は、埋め込み HTML が無効になっている場合でも、HTML のような<del>stricken</del>構文をサポートします。

AsciiDoc は、組み込みのテキスト span [c]プレフィックスを通じて、強調表示されたテキストをサポートします[.line-through]#stricken#

プログラミング構文

引用符で囲まれたコンピュータコードは、伝統的にタイプライターのようなフォントで表現され、各文字は同じ固定幅を占めます。HTMLは、このタスクのために、セマンティック要素<code>と、非推奨のプレゼンテーション<tt>要素 を提供しています

等幅フォント、テレタイプテキストまたはコード
コード
AsciiDoc
ATX
クレオール
Gemtext
ジラ
マークダウン
オルグモード
PmWiki
reST
スラック
テキスタイル
セクシー!
ティドリーウィキ
txt2tags
WhatsApp
@code@ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ
@@code@@ いいえ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ
`code` はい いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ はい いいえ はい はい いいえ はい
``code`` はい いいえ いいえ いいえ いいえ はい いいえ いいえ はい いいえ いいえ いいえ はい はい いいえ
```code``` いいえ いいえ いいえ はい いいえ はい いいえ いいえ いいえ はい/いいえ いいえ いいえ はい いいえ いいえ
=code= いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
~code~ いいえ いいえ いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
+code+ はい/いいえ[b] いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
++code++ はい/いいえ[b] いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
{{code}} いいえ いいえ いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
{{{code}}} いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
|code| いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
;;code;;

MediawikiとGemtextは、インラインコード範囲用の軽量マークアップを提供していません

見出し構文

見出しは通常最大6レベルまで使用できますが、最上位レベルは文書タイトルと同じ内容を格納するために予約されていることが多く、文書タイトルは外部から設定される場合があります。一部の文書では、レベルを部、章、節、条、段落などの区分タイプと関連付けている場合があります。この記事では1を最上位レベルとしていますが、公式文書では見出しレベルのインデックスは1または0から始まる場合があります

ほとんどのLMLは、見出しにSetextのような下線かatxのような[50]行マーカー の2つのスタイルのいずれかを採用しており、その両方をサポートしています。

下線付き見出し

レベル1見出し
===============

レベル2見出し
---------------

レベル3見出し
~~~~~~~~~~~~~~~

最初のスタイルでは、見出しテキストの下の行に 下線、つまり繰り返される文字(例:イコール=、ハイフン-、チルダなど、通常は少なくとも2回または4回)を使用します~

下線付き見出しレベル
文字
言語
= - ~ * # + ^ _ : " ' ` . 最小文字数
AsciiDoc [b] 1 2 3 いいえ いいえ 5 4 いいえ いいえ いいえ いいえ いいえ いいえ 2 [d]
マークダウン 1 2 いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 1
reStructuredText 見出し構造は、見出しの連続から動的に決定されます 見出しの幅
Setext 1 2 いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ
セクシー! 3 4 いいえ 2 1 いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 3

reStructuredTextでは、見出しに下線を引くだけでなく、 オプションで上線を引くこともできます。

接頭辞付き見出し

# レベル1見出し
## レベル2見出し ##
### レベル3見出し ###

#2つ目のスタイルは、見出し自体の先頭に繰り返しマーカー(ハッシュ、イコール=、アスタリスクなど)を配置し*、その繰り返し回数が見出しレベル(場合によっては逆)を示します。ほとんどの言語では行末のマーカーの繰り返しもサポートされていますが、必須としている言語もあれば、必ずしもマーカーの数が一致している必要のない言語もあります。

行頭(および行末)見出し
文字
言語
= # * ! + サフィックス レベル インデント
AsciiDoc はい いいえ いいえ いいえ いいえ 任意 1~6 いいえ
クレオール はい いいえ いいえ いいえ いいえ 任意 1~6 いいえ
DokuWiki はい いいえ いいえ いいえ いいえ はい 6-1 いいえ
Gemtext いいえ はい いいえ いいえ いいえ 1~3 いいえ
マークダウン いいえ はい いいえ いいえ いいえ 任意 1~6 いいえ
メディアウィキ はい いいえ いいえ いいえ いいえ はい 1~6 いいえ
オルグモード いいえ いいえ はい いいえ いいえ いいえ 1– +∞ 代替案[51] [52] [53]
PmWiki いいえ いいえ いいえ はい いいえ 任意 1~6 いいえ
セクシー! はい はい いいえ いいえ いいえ 任意 6–1、ダイナミック いいえ
ティドリーウィキ いいえ いいえ いいえ はい いいえ いいえ 1~6 いいえ
txt2tags はい いいえ いいえ いいえ はい はい 1~6 いいえ

Org-mode はレベルを示す手段としてインデントをサポートしています。

BBCode はセクション見出しをまったくサポートしていません。

POD と Textile では、代わりに番号付き見出しレベルの HTML 規則を選択します。

その他の見出し形式
言語 形式
POD
=head1 レベル1の見出し
=head2 レベル2の見出し
ジラ[6]繊維[49]
h1. レベル1の見出し
h2. レベル2の見出し
h3. レベル3の見出し
h4. レベル4の見出し
h5. レベル5の見出し
h6. レベル6の見出し

Microsoft Wordは、段落が数語以内で、末尾にピリオドがなく、ユーザーがEnterキーを2回押すと、段落を見出しとして自動書式設定します。より低いレベルの見出しの場合は、テキストを入力する前に、対応する回数だけタブキーを押すことができます。例えば、見出しレベル2~9の場合は、1~8回のタブキーを押すことができます。

ハイパーリンクはインラインで追加できますが、URLが長いためコードが煩雑になる可能性があります。また、アドレスと関連属性のみを含む行への名前付きaliasまたは番号付きid参照として追加することもできます。ハイパーリンクはドキュメント内の任意の場所に配置できます。ほとんどの言語では、作成者がプレーンTextアドレスの代わりに表示するテキストを指定できhttp://example.com、リンク先に関する詳細情報を含む別のリンクタイトルを設定するメソッドも用意されていますTitle

Wiki やコード ドキュメントなどの特別な設定に合わせて調整された LML は、ドキュメント内に名前付きアンカー (見出し、関数など) を自動的に生成したり、関連ページ (おそらく別の名前空間) にリンクしたり、リンクされたキーワードのテキスト検索を提供したりします。

ほとんどの言語では、リンクを囲むために(二重の)角括弧または山括弧を使用しますが、2つの言語が完全に互換性を持つものはほとんどありません。多くの言語では、追加のマークアップなしで、テキスト内の絶対URLを自動的に認識して解析できます。

ハイパーリンク構文
言語 基本構文 テキスト構文 タイトル構文
AsciiDoc http://example.com[Text] http://example.com
BBCode、Creole、MediaWiki、PmWiki
Slack <http://example.com|Text>
テキスタイル "Text":http://example.com "Text (Title)":http://example.com
テキシー! "Text .(Title)":http://example.com
ジラ [http://example.com] [Text|http://example.com]
メディアウィキ [http://example.com Text]
txt2tags [Text http://example.com]
クレオール語、MediaWiki、PmWiki、DokuWiki [[Name]] [[Name|Text]]
Org-mode [[Name][Text]]
TiddlyWiki [[Text|Name]]
クレオール [[Namespace:Name]] [[Namespace:Name|Text]]
Org-mode [[Namespace:Name][Text]]
クレオール、PmWiki [[http://example.com]] [[http://example.com|Text]]
BBコード [url]http://example.com[/url] [url=http://example.com]Text[/url]
マークダウン <http://example.com> [Text](http://example.com) [Text](http://example.com "Title")
構造化テキスト `Text <http://example.com/>`_
ジェムテキスト => gemini://example.com => gemini://example.com Text
POD L<http://example.com/> L</Name>
シーテキスト ^.. _Link_name URL

ジェムテキストとシーテキストのリンクは、それぞれ単独で1行に記述する必要があり、インラインで使用することはできません

参照構文
言語 テキスト構文 タイトル構文
AsciiDoc
… [[id]] …
<<id>>
… [[id]] …
<<id,Text>>
… アンカー:id …
外部参照:id
… アンカー:id …
外部参照:id[テキスト]
マークダウン
… [テキスト][ id ] …
[ id ]: http://example.com
… [テキスト][ id ] …
[ id ]: http://example.com "タイトル"
… [文章][] …
[テキスト]: http://example.com
… [文章][] …
[テキスト]: http://example.com "タイトル"
… [テキスト] …
[テキスト]: http://example.com
… [テキスト] …
[テキスト]: http://example.com "タイトル"
構造化テキスト
… 名前_ …
 ..  _名前: http://example.com
シーテキスト
… リンク名 …
^.. _リンク名 URL
テキスタイル
… "テキスト":エイリアス …
[エイリアス]http://example.com
… "テキスト":エイリアス …
[エイリアス(タイトル)]http://example.com
テキシー!
… "テキスト":エイリアス …
[エイリアス]: http://example.com
… "テキスト":エイリアス …
[エイリアス]: http://example.com (タイトル)

Org-modeの通常のリンク構文では、ファイルのテキスト検索が行われます。また、 . を使って専用のターゲットを指定することもできます<<id>>

メディアと外部リソースの構文

リスト構文

HTMLでは、リストの種類を指定するための明示的な要素と、リスト項目ごとに1つの要素が必要ですが、ほとんどの軽量マークアップ言語では、箇条書きや列挙項目に異なる行プレフィックスのみが必要です。入れ子のリストにインデントを使用する言語もあれば、親リストマーカーを繰り返し使用する言語もあります

順序なしの箇条書き項目
文字
言語
* - + # . · _ : インデント スキップ ネスト
AsciiDoc はい はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0 [e] マーカー を繰り返すか交互にする
DokuWiki はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 2+ 0+ インデント
Gemtext はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0 1+ 該当なし
ジラ はい はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0 1+ 繰り返し
マークダウン はい はい はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0~3 1~3 インデント
MediaWikiTiddlyWiki はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0 1+ 繰り返し
オルグモード はい[54] はい はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0+ インデント
テキスタイル はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0 1+ 繰り返し
セクシー! はい はい はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 2+ インデント

Microsoft Wordは、アスタリスク*、ハイフンとマイナス記号-、または大なり括弧で始まり>、その後にスペースまたは水平タブが続く段落を、自動的に箇条書きリスト項目に変換します。また、数字の1と大文字と小文字を区別しない文字a(アルファベット順リストの場合)またはi. (ローマ数字の場合)の後にピリオド、閉じ括弧)、大なり記号>、ハイフンとマイナス記号、そしてスペースまたはタブが続く場合は、それらの列挙リストを開始します。-丸括弧の場合は、(リストマーカーの前にオプションで開き括弧を置くこともできます

言語によって、番号付きリスト項目における数字のオプションまたは必須のサポートの有無、どのような種類の列挙子(例:10進数の数字1、ローマ数字のiまたはI、アルファベットのaまたはA)、そして出力形式で明示的な値を保持するかどうかは異なります。例えば、一部のMarkdown方言では、開始値が1以外の場合は尊重されますが、それ以外の明示的な値は無視されます。

順序付けされた列挙リスト項目
文字
言語
+ # - . #1 1. 1) 1] 1} (1) [1] {1} a. A. i. I. インデント スキップ ネスト
AsciiDoc いいえ いいえ いいえ はい いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ はい[f] 0 [e] マーカー を繰り返すか交互にする
DokuWiki いいえ いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 2+ 0+ インデント
JiraMediaWikiTextileTiddlyWiki いいえ はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0 1+ 繰り返し
マークダウン いいえ いいえ いいえ いいえ いいえ はい はい いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ いいえ 0~3 1~3 インデント
オルグモード いいえ いいえ いいえ いいえ いいえ はい はい いいえ いいえ いいえ いいえ いいえ 任意 いいえ いいえ 0+ インデント
セクシー! いいえ いいえ いいえ いいえ いいえ はい はい いいえ いいえ いいえ いいえ いいえ )区切り文字のみ いいえ )区切り文字のみ 2+ インデント

Slack は、ユーザーによる列挙リストや箇条書きリストの入力を支援しますが、実際にそれらのリストをそのようにフォーマットするわけではありません。つまり、先頭の数字、それに続くピリオド、スペース、または行頭の箇条書き文字が含まれるだけです。

ラベル付き、用語集、説明/定義リストの構文
言語 定義対象の用語 用語の定義
AsciiDoc Term:: 特定の要件はありません。順序付きリストまたは順序なしリストと混在させることができ、ネストは任意です
Term::::
Term;;
メディアウィキ ; Term : Definition
テキスタイル
ティドリーウィキ
セクシー!
用語
    定義
オルグモード - Term :: Definition

引用構文

表構文

歴史的形式

以下の軽量マークアップ言語は、すでに述べたもののいくつかと似ていますが、この記事の比較表にはまだ追加されていません

  • EtText: [55] 2000年頃。
  • Grutatext: [56] 2002年頃。

参照

注記

  1. ^ JTexyはTexy! 1.0の構文と完全な互換性があり、2.0以降とも一部互換性があります
  2. ^ abcdefg Asciidoctor 2.0 では非推奨です。これ以降のバージョンは言語の現在の表現を表し、2025 年 4 月時点でまだ作成されている標準に準拠しています。この構文は、互換モードを通じて引き続き利用できます。
  3. ^ AsciiDoc のテキスト範囲は、従来の実装では引用符で囲まれたテキスト属性と呼ばれます。
  4. ^ タイトルの幅 ± 2 文字
  5. ^ ab AsciiDoc で 1 つの空白文字でインデントすると、その行のテキストが事前にフォーマットされます。
  6. ^ 現代の言語仕様では、順序付きリストの区切り文字としてピリオドのみがサポートされています。従来のAsciiDoc.py構文では、小文字の英字またはローマ数字には右括弧のみが使用できました。

参考文献

  1. ^ 「AsciiDoc ChangeLog」 。 2017年2月24閲覧
  2. ^ 「WikiCreole Versions」 . 2017年2月24日閲覧
  3. ^ ab "djot" . 2023年8月26日閲覧
  4. ^ "djot 0.1.0". GitHub . 2023年8月26日閲覧。
  5. ^ 「DokuWiki old_changes」 . 2024年11月26日閲覧
  6. ^ ab Jira. 「テキスト書式表記ヘルプ」. Atlassian . 2020年12月22日閲覧
  7. ^ "Markdown". Aaron Swartz: The Weblog . 2004年3月19日.
  8. ^ “Daring Fireball: Markdown”. 2004年4月2日時点のオリジナルよりアーカイブ2014年4月25日閲覧。
  9. ^ 「PHP Markdown Extra」. Michel Fortin . 2013年10月8日閲覧
  10. ^ 「PHP Markdown:歴史」Michel Fortin . 2020年12月23日閲覧
  11. ^ 「MediaWikiの歴史」 。 2017年2月24日閲覧
  12. ^ abc Pandoc Archived 2013-11-15 at the Wayback MachineはHaskellで書かれており、 Markdown (2 つの形式) とReStructuredTextのほか、 HTML と LaTeX を解析します。これらの形式からHTMLRTFLaTeXConTeXtOpenDocumentEPUB、および (LaTeX 経由の) PDF を含むその他の形式に書き込むことができます。
  13. ^ 「Org mode for Emacs – プレーンテキストで人生を」. orgmode.org . OrgModeチーム. 2016年12月9日閲覧
  14. ^ 「PmWiki Cookbook - アドオンのエクスポート」 。 2018年1月7日閲覧
  15. ^ 「reStructuredText入門」 。 2017年2月24日閲覧
  16. ^ 「新しいフォーマットのTidBITS」. TidBITS . 1992年1月6日. 2022年7月1日閲覧
  17. ^ 「Slackヘルプセンター > Slackの使い方 > メッセージの送信 > メッセージのフォーマット」 。 2018年8月7日閲覧
  18. ^ 「Slack APIドキュメント:基本的なメッセージフォーマット」 。 2018年8月7日閲覧
  19. ^ 「Textism › Tools › Textile」. textism.com . 2002年12月26日時点のオリジナルよりアーカイブ。
  20. ^ 「Texyとは何か」 。 2017年2月24日閲覧
  21. ^ 「TiddlyWikiの歴史」. tiddlywiki.com .
  22. ^ "Html2wiki txt2tagsモジュール". MetaCPAN.cpan.org . 2014年1月30日閲覧
  23. ^ 「Txt2tags ユーザーガイド」Txt2tags.org . 2017年2月24日閲覧
  24. ^ "txt2tags changelog" . 2017年2月24日閲覧。
  25. ^ 「WhatsApp FAQ: メッセージのフォーマット」 。 2017年11月21日閲覧
  26. ^ 「Txt2tags ユーザーガイド」Txt2tags.org . 2017年2月24日閲覧
  27. ^ 「DokuWiki Tips htmltowiki」 . 2024年11月26日閲覧
  28. ^ ab "DokuWiki FAQ html" . 2024年11月26日閲覧。
  29. ^ 「コンバータ」. WikiCreole . 2013年10月8日閲覧
  30. ^ pegdown: Markdown処理用のJavaライブラリ
  31. ^ ab gfms: Github 風味のマークダウンサーバー
  32. ^ ab marked: JavaScript で書かれた、フル機能の Markdown パーサーおよびコンパイラ。高速化のために構築されています。
  33. ^ ab node-gfm: GitHub風のマークダウンからHTMLへのコンバータ
  34. ^ Parsedown: PHP で書かれた Markdown パーサー
  35. ^ ab Ciconia: PHPで書かれたMarkdownパーサー
  36. ^ ab Grip: GitHub Readme インスタントプレビュー
  37. ^ github-markdown: GitHub用の自己完結型Markdownパーサー
  38. ^ peg-markdown は Cでのmarkdownの実装です
  39. ^ Discount も Cでのmarkdownの実装です
  40. ^ "Python-Markdown". Github.com . 2013年10月8日閲覧。
  41. ^ Bruce Williams. 「kramdown: プロジェクト情報」. RubyForge. 2013年8月7日時点のオリジナルよりアーカイブ。 2013年10月8日閲覧
  42. ^ ab "ox-pandoc および pandoc 自体経由". GitHub
  43. ^ Atlassian. 「Confluence 4.0 エディター - Wiki マークアップユーザー向けの変更点(Confluence Wiki マークアップは廃止されました)」 . 2018年3月28日閲覧
  44. ^ Docutilsは PythonReStructuredTextの実装です
  45. ^ SphinxはPythonとDocutilsでReStructuredTextを実装したもので、多数の出力形式ビルダーを備えています。
  46. ^ Aurelio Jargas www.aurelio.net (2012年1月11日). 「txt2tags」. txt2tags . 2013年10月8日閲覧
  47. ^ "txt2tags.class.php - オンラインコンバーター [sic]". Txt2tags.org . 2013年10月8日閲覧
  48. ^ 「Markdown構文」Daringfireball.net . 2013年10月8日閲覧
  49. ^ ab Textile Syntax 2010年8月12日アーカイブ、Wayback Machine
  50. ^ 「atx、真の構造化テキストフォーマット」アーロン・シュワルツ著(2002年)
  51. ^ 「The Org Manual: section "A Cleaner Outline View"」 。 2020年6月14日閲覧
  52. ^ 「org-adapt-indentation を使用する」。
  53. ^ 「org-indent-mode または org-indent を使用する」。
  54. ^ 公式マニュアルの脚注「'*' を箇条書きとして使用する場合、見出しとして解釈されないように行をインデントする必要があります。また、アウトライン表示をすっきりさせるために先頭の星印を非表示にしている場合、星印で始まる通常のリスト項目と実際の見出しを区別するのが難しくなる可能性があります。つまり、'*' はサポートされていますが、通常のリスト項目には使用しない方が良いでしょう。」
  55. ^ 「EtText: ドキュメント: EtTextの使用」. ettext.taint.org . 2022年6月30日閲覧元々はWebMake[1]プロジェクトから派生したものです。
  56. ^ “Un naufragio personal: The Grutatxt markup”. triptico.com . 2022年6月30日時点のオリジナルよりアーカイブ2022年6月30日閲覧。パブリック ドメイン形式 (バージョン 2.20 以降)。元々は Gruta CMSシステムで使用されていました。
  • ウィキブックスのCurl
「https://en.wikipedia.org/w/index.php?title=Lightweight_markup_language&oldid=1328547895」より取得