軽量マークアップ言語(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>
ほとんどの言語では、行またはブロックのマークアップと、短いテキスト範囲のマークアップを区別しますが、インライン マークアップのみをサポートする言語もあります。
マークアップ言語の中には、コンピュータコードの文書化(例:POD、reST、RD)や特定の出力形式(通常はHTMLまたはLaTeX)への変換など、特定の目的に特化したものがありますが、より汎用的な用途を持つものもあります。これには、テキスト表示を重視するか、データのシリアル化を重視するかが含まれます。[説明が必要]
プレゼンテーション指向の言語には、AsciiDoc、atx、BBCode、Creole、 Crossmark 、 Djot 、 Epytext 、Haml、JsonML、MakeDoc、Markdown、Org-mode、POD (Perl)、reST (Python)、RD (Ruby)、Setext、SiSU、SPIP、 Xupl 、Texy!、 Textile 、txt2tags、UDO、Wikitextなどがあります。
データシリアル化指向の言語には、Curl (同形言語ですが JSON も読み取り、すべてのオブジェクトがシリアル化されます)、JSON、YAMLなどがあります。
このセクションは、上記で説明した言語の種類との比較表を追加して拡張する必要があります。他の高水準の表と統合することもできます。拡張することで、皆さんのご協力をお願いします。 ( 2014年6月) |
言語機能の比較
| 言語 | 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] |
| いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 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 | DocBook | ODF | EPUB | DOC (X) | LML | その他 | ライセンス | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| AsciiDoc | Python、Ruby、JavaScript、Java | XHTML | LaTeX | DocBook | ODF | EPUB | いいえ | 該当なし | マニュアルページなど | GNU GPL、MIT | |
| BBコード | Perl、PHP、C#、Python、Ruby | (X)HTML | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 該当なし | 該当なし | パブリックドメイン |
| クレオール | PHP、Python、Ruby、JavaScript [29] | 実装に依存 | CC_BY-SA 1.0 | ||||||||
| Djot | Lua(オリジナル)、JavaScript、PHP、Prolog、Rust [3] | HTML | LaTeX、ConTeXt | DocBook | ODF | EPUB | RTF | MediaWiki、reST | マニュアルページ、S5など | MIT | |
| GitHub Flavored Markdown | Haskell ( Pandoc ) | HTML | LaTeX、ConTeXt | DocBook | ODF | EPUB | DOC | AsciiDoc、reST | 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] JavaScript、Haskell、[12] Ruby、[41] C#、Java、PHP | HTML | LaTeX、ConTeXt | DocBook | ODF | EPUB | RTF | MediaWiki、reST | マニュアルページ、S5など | BSDスタイルとGPL(両方) | |
| Markdown Extra | PHP(オリジナル)、Python、Ruby | XHTML | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 該当なし | 該当なし | BSDスタイルとGPL(両方) |
| メディアウィキ | Perl、PHP、Haskell、Python | XHTML | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 該当なし | 該当なし | GNU GPL |
| マルチマークダウン | C、Perl | (X)HTML | LaTeX | いいえ | ODF | いいえ | DOC、RTF | 該当なし | OPML | GPL、MIT | |
| オルグモード | Emacs Lisp、Ruby(パーサーのみ)、Perl、OCaml | XHTML | LaTeX | DocBook | ODF | EPUB [42] | DOCX [42] | マークダウン | TXT、XOXO、iCalendar、Texinfo、man、contrib: groff、s5、deck.js、Confluence Wikiマークアップ、[43] TaskJuggler、RSS、FreeMind | GPL | |
| PmWiki | PHP | XHTML 1.0 Transitional、HTML5 | いいえ | PDFエクスポートアドオン | いいえ | いいえ | EPUBエクスポートアドオン | いいえ | 該当なし | 該当なし | GNU GPL |
| POD | Perl | (X)HTML、XML | LaTeX | DocBook | いいえ | いいえ | RTF | 該当なし | マニュアルページ、プレーンテキスト | Artistic License、Perlのライセンス | |
| reStructuredText | Python、[44] [45] Haskell (Pandoc)、Java、 | HTML、XML | LaTeX | DocBook | ODF | EPUB | DOC | 該当なし | man、S5、Devhelp、QTヘルプ、CHM、JSON | パブリックドメイン | |
| テキスタイル | PHP、JavaScript、Java、Perl、Python、Ruby、ASP、C#、Haskell | XHTML | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 該当なし | 該当なし | テキスタイルライセンス |
| セクシー! | PHP、C#、Java [a] | (X)HTML | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 該当なし | 該当なし | GNU GPL v2ライセンス |
| txt2tags | Python、[46]、 PHP [47] | (X)HTML、SGML | LaTeX | DocBook | ODF | EPUB | DOC | Creole、AsciiDoc、MediaWiki、MoinMoin、PmWiki、DokuWiki、Google Code Wiki | roff、man、MagicPoint、 Lout 、PageMaker、ASCII アート、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
|
最初の 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``
|
|
*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 | |
|---|---|---|---|---|---|---|---|---|---|
~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>>。
メディアと外部リソースの構文
このセクションは、埋め込まれた画像、音声、動画、その他の種類のメディア(ソーシャルメディアのリンクなど)を言語がどのように処理するかを示す比較表を追加して拡張する必要があります。拡張することで、皆様のご協力をお願いいたします。 (2014年6月) |
リスト構文
HTMLでは、リストの種類を指定するための明示的な要素と、リスト項目ごとに1つの要素が必要ですが、ほとんどの軽量マークアップ言語では、箇条書きや列挙項目に異なる行プレフィックスのみが必要です。入れ子のリストにインデントを使用する言語もあれば、親リストマーカーを繰り返し使用する言語もあります
文字 言語
|
*
|
-
|
+
|
#
|
.
|
·
|
•
|
_
|
:
|
–
|
—
|
インデント | スキップ | ネスト |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AsciiDoc | はい | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 0 [e] | ? | マーカー を繰り返すか交互にする |
| DokuWiki | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 2+ | 0+ | インデント |
| Gemtext | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 0 | 1+ | 該当なし |
| ジラ | はい | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 0 | 1+ | 繰り返し |
| マークダウン | はい | はい | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 0~3 | 1~3 | インデント |
| MediaWiki、TiddlyWiki | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 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+ | インデント |
| Jira、MediaWiki、Textile、TiddlyWiki | いいえ | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 0 | 1+ | 繰り返し |
| マークダウン | いいえ | いいえ | いいえ | いいえ | いいえ | はい | はい | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ | 0~3 | 1~3 | インデント |
| オルグモード | いいえ | いいえ | いいえ | いいえ | いいえ | はい | はい | いいえ | いいえ | いいえ | いいえ | いいえ | 任意 | いいえ | いいえ | 0+ | インデント | ||
| セクシー! | いいえ | いいえ | いいえ | いいえ | いいえ | はい | はい | いいえ | いいえ | いいえ | いいえ | いいえ | )区切り文字のみ |
いいえ | )区切り文字のみ |
2+ | ? | インデント | |
Slack は、ユーザーによる列挙リストや箇条書きリストの入力を支援しますが、実際にそれらのリストをそのようにフォーマットするわけではありません。つまり、先頭の数字、それに続くピリオド、スペース、または行頭•の箇条書き文字が含まれるだけです。
| 言語 | 定義対象の用語 | 用語の定義 |
|---|---|---|
| AsciiDoc | Term::
|
特定の要件はありません。順序付きリストまたは順序なしリストと混在させることができ、ネストは任意です |
Term::::
| ||
Term;;
| ||
| メディアウィキ | ; Term
|
: Definition
|
| テキスタイル | ||
| ティドリーウィキ | ||
| セクシー! | 用語
定義
| |
| オルグモード | - Term :: Definition
| |
引用構文
このセクションは、インライン引用とブロック引用の区別、および帰属表示の扱いについて、 拡充が必要です。ぜひ拡充にご協力ください。 (2014年6月) |
表構文
このセクションは、セル、行、列、ヘッダー、キャプションの拡張が必要です。拡張してご協力ください。 (2014年6月) |
歴史的形式
以下の軽量マークアップ言語は、すでに述べたもののいくつかと似ていますが、この記事の比較表にはまだ追加されていません
- EtText: [55] 2000年頃。
- Grutatext: [56] 2002年頃。
参照
注記
- ^ JTexyはTexy! 1.0の構文と完全な互換性があり、2.0以降とも一部互換性があります
- ^ abcdefg Asciidoctor 2.0 では非推奨です。これ以降のバージョンは言語の現在の表現を表し、2025 年 4 月時点でまだ作成されている標準に準拠しています。この構文は、互換モードを通じて引き続き利用できます。
- ^ AsciiDoc のテキスト範囲は、従来の実装では引用符で囲まれたテキスト属性と呼ばれます。
- ^ タイトルの幅 ± 2 文字
- ^ ab AsciiDoc で 1 つの空白文字でインデントすると、その行のテキストが事前にフォーマットされます。
- ^ 現代の言語仕様では、順序付きリストの区切り文字としてピリオドのみがサポートされています。従来のAsciiDoc.py構文では、小文字の英字またはローマ数字には右括弧のみが使用できました。
参考文献
- ^ 「AsciiDoc ChangeLog」 。 2017年2月24日閲覧
- ^ 「WikiCreole Versions」 . 2017年2月24日閲覧。
- ^ ab "djot" . 2023年8月26日閲覧。
- ^ "djot 0.1.0". GitHub . 2023年8月26日閲覧。
- ^ 「DokuWiki old_changes」 . 2024年11月26日閲覧。
- ^ ab Jira. 「テキスト書式表記ヘルプ」. Atlassian . 2020年12月22日閲覧。
- ^ "Markdown". Aaron Swartz: The Weblog . 2004年3月19日.
- ^ “Daring Fireball: Markdown”. 2004年4月2日時点のオリジナルよりアーカイブ。2014年4月25日閲覧。
- ^ 「PHP Markdown Extra」. Michel Fortin . 2013年10月8日閲覧。
- ^ 「PHP Markdown:歴史」Michel Fortin . 2020年12月23日閲覧。
- ^ 「MediaWikiの歴史」 。 2017年2月24日閲覧。
- ^ abc Pandoc Archived 2013-11-15 at the Wayback MachineはHaskellで書かれており、 Markdown (2 つの形式) とReStructuredTextのほか、 HTML と LaTeX を解析します。これらの形式からHTML、RTF、LaTeX、ConTeXt、OpenDocument、EPUB、および (LaTeX 経由の) PDF を含むその他の形式に書き込むことができます。
- ^ 「Org mode for Emacs – プレーンテキストで人生を」. orgmode.org . OrgModeチーム. 2016年12月9日閲覧。
- ^ 「PmWiki Cookbook - アドオンのエクスポート」 。 2018年1月7日閲覧。
- ^ 「reStructuredText入門」 。 2017年2月24日閲覧。
- ^ 「新しいフォーマットのTidBITS」. TidBITS . 1992年1月6日. 2022年7月1日閲覧。
- ^ 「Slackヘルプセンター > Slackの使い方 > メッセージの送信 > メッセージのフォーマット」 。 2018年8月7日閲覧。
- ^ 「Slack APIドキュメント:基本的なメッセージフォーマット」 。 2018年8月7日閲覧。
- ^ 「Textism › Tools › Textile」. textism.com . 2002年12月26日時点のオリジナルよりアーカイブ。
- ^ 「Texyとは何か」 。 2017年2月24日閲覧。
- ^ 「TiddlyWikiの歴史」. tiddlywiki.com .
- ^ "Html2wiki txt2tagsモジュール". MetaCPAN.cpan.org . 2014年1月30日閲覧。
- ^ 「Txt2tags ユーザーガイド」Txt2tags.org . 2017年2月24日閲覧。
- ^ "txt2tags changelog" . 2017年2月24日閲覧。
- ^ 「WhatsApp FAQ: メッセージのフォーマット」 。 2017年11月21日閲覧。
- ^ 「Txt2tags ユーザーガイド」Txt2tags.org . 2017年2月24日閲覧。
- ^ 「DokuWiki Tips htmltowiki」 . 2024年11月26日閲覧。
- ^ ab "DokuWiki FAQ html" . 2024年11月26日閲覧。
- ^ 「コンバータ」. WikiCreole . 2013年10月8日閲覧。
- ^ pegdown: Markdown処理用のJavaライブラリ
- ^ ab gfms: Github 風味のマークダウンサーバー
- ^ ab marked: JavaScript で書かれた、フル機能の Markdown パーサーおよびコンパイラ。高速化のために構築されています。
- ^ ab node-gfm: GitHub風のマークダウンからHTMLへのコンバータ
- ^ Parsedown: PHP で書かれた Markdown パーサー
- ^ ab Ciconia: PHPで書かれたMarkdownパーサー
- ^ ab Grip: GitHub Readme インスタントプレビュー
- ^ github-markdown: GitHub用の自己完結型Markdownパーサー
- ^ peg-markdown は Cでのmarkdownの実装です。
- ^ Discount も Cでのmarkdownの実装です。
- ^ "Python-Markdown". Github.com . 2013年10月8日閲覧。
- ^ Bruce Williams. 「kramdown: プロジェクト情報」. RubyForge. 2013年8月7日時点のオリジナルよりアーカイブ。 2013年10月8日閲覧。
- ^ ab "ox-pandoc および pandoc 自体経由". GitHub。
- ^ Atlassian. 「Confluence 4.0 エディター - Wiki マークアップユーザー向けの変更点(Confluence Wiki マークアップは廃止されました)」 . 2018年3月28日閲覧。
- ^ Docutilsは PythonのReStructuredTextの実装です
- ^ SphinxはPythonとDocutilsでReStructuredTextを実装したもので、多数の出力形式ビルダーを備えています。
- ^ Aurelio Jargas www.aurelio.net (2012年1月11日). 「txt2tags」. txt2tags . 2013年10月8日閲覧。
- ^ "txt2tags.class.php - オンラインコンバーター [sic]". Txt2tags.org . 2013年10月8日閲覧。
- ^ 「Markdown構文」Daringfireball.net . 2013年10月8日閲覧。
- ^ ab Textile Syntax 2010年8月12日アーカイブ、Wayback Machine
- ^ 「atx、真の構造化テキストフォーマット」アーロン・シュワルツ著(2002年)
- ^ 「The Org Manual: section "A Cleaner Outline View"」 。 2020年6月14日閲覧。
- ^ 「org-adapt-indentation を使用する」。
- ^ 「org-indent-mode または org-indent を使用する」。
- ^ 公式マニュアルの脚注「'*' を箇条書きとして使用する場合、見出しとして解釈されないように行をインデントする必要があります。また、アウトライン表示をすっきりさせるために先頭の星印を非表示にしている場合、星印で始まる通常のリスト項目と実際の見出しを区別するのが難しくなる可能性があります。つまり、'*' はサポートされていますが、通常のリスト項目には使用しない方が良いでしょう。」
- ^ 「EtText: ドキュメント: EtTextの使用」. ettext.taint.org . 2022年6月30日閲覧。元々はWebMake[1]プロジェクトから派生したものです。
- ^ “Un naufragio personal: The Grutatxt markup”. triptico.com . 2022年6月30日時点のオリジナルよりアーカイブ。2022年6月30日閲覧。パブリック ドメイン形式 (バージョン 2.20 以降)。元々は Gruta CMSシステムで使用されていました。