 | |
| MIMEタイプ | text/markdown[1] |
|---|---|
| 開発者 | ジョン・グルーバー（英語版） |
| 初版 | 2004年3月19日 (21年前) (2004-03-19)[2] |
| 最新版 | 1.0.1 (2004年12月17日 (21年前) (2004-12-17)[3]) |
| 種別 | 軽量マークアップ言語 |
| 拡張 | MultiMarkdown（英語版） Markdown Extra（英語版） CommonMark（英語版） |
| ウェブサイト | daringfireball |
| テンプレートを表示 | |
Markdown（マークダウン）とは、プレーンテキスト形式で書式付きテキストを記述する軽量マークアップ言語である。
テキストエディタで手軽に書いた文書からHTMLを生成するために開発されたが、PowerPoint形式やLaTeX形式のファイルへ変換するソフトウェア（コンバータ）も開発されている。各コンバータの開発者によって拡張が施された各種の方言が存在する。
「書きやすくて読みやすいプレーンテキストとして記述した文書を、妥当なXHTML（もしくはHTML）文書へと変換できるフォーマット」として、ジョン・グルーバー（英語版）により作成された。アーロン・スワーツも大きな貢献をしている[4]。Markdownの記法の多くは、電子メールにおいてプレーンテキストを装飾する際の慣習から着想を得ている。
Markdownはグルーバーによって書かれたMarkdown.plというPerlプログラムを指すこともある。このスクリプトは、Markdownの形式でマークアップされたテキストをXHTML文書もしくはHTML文書に変換するものである。Markdown.plはスクリプト単体として利用することができると同時に、BlosxomやMovable Typeのプラグインなどからも利用できる[4]。
Markdown.plは、その後第三者によってCPANのPerlモジュール (Text::Markdown) として再実装され、さらにPython等の他のプログラミング言語でも実装された。MarkdownはBSDライセンスの下で配布され、いくつかのコンテンツ管理システム (CMS) でもプラグインとして利用できる[5][6]。
有名なMarkdown方言としてCommonMark（英語版）[1]、Markdown Extra（英語版）[2]やGitHub Flavored Markdown（英語版）[3]、Marukuなどがある。その他のサービス・コンバータにおいても表やソースコードの記法などで独自の拡張が加えられていることが多い。以下にMarkdownの利用例を挙げる。
以下の例はMarkdownの記法の包括的なリストではないし、ひとつの効果を実現するために複数の記法が利用できる場合も多い。詳細はfull Markdown syntaxに記載されている。
段落は1つ以上の連続したテキストであり、空行によって分けられる。通常の段落をスペースやタブでインデントしてはならない。
これは段落です。2つの文があります。これは別の段落です。ここにも2つの文があります。
テキストに挿入された改行は取り除かれる。これは、画面の大きさに応じて改行を行う処理はWebブラウザが担当すべきであるという設計思想による。強制的に改行したい場合は、2つ以上のスペースを行末に残した上で改行すると <br> になる。
テキストの前にいくつかの'#'を置くことで見出しを作ることができる。'#'の数が見出しのレベルに対応する。HTMLは見出しのレベルを6まで提供している。
# レベル1の見出し## レベル2の見出し### レベル3の見出し#### レベル4の見出し##### レベル5の見出し###### レベル6の見出し
最初の2つのレベルには代替の記法が存在する。
レベル1の見出し===============レベル2の見出し---------------
>"このテキストは、HTMLのblockquote要素に囲まれます。blockquote要素はreflowableです。テキストを好きなように改行することができます。改行したとしても、変換後はひとつのblockquote要素として扱われます。"
上記は次のようなHTMLに変換される。
<blockquote><p>このテキストは、HTMLのblockquote要素に囲まれます。blockquote要素はreflowableです。テキストを好きなように改行することができます。改行したとしても、変換後はひとつのblockquote要素として扱われます。</p></blockquote>
*順序無しリストのアイテム*サブアイテムはタブもしくは4つのスペースでインデントする*順序無しリストの別のアイテム+ 順序無しリストのアイテム + サブアイテムはタブもしくは4つのスペースでインデントする+ 順序無しリストの別のアイテム-順序無しリストのアイテム-サブアイテムはタブもしくは4つのスペースでインデントする-順序無しリストの別のアイテム1. 順序付きリストのアイテム1. サブアイテムはタブもしくは4つのスペースでインデントする2. 順序付きリストの別のアイテム
コード（等幅フォントで整形される）を含める場合、インラインコードは「`some code`」のようにバッククオート (U+0060) で囲むことになる。
これは段落です。文中に`コードテキスト`を含みます。
複数行にまたがるコードは、タブもしくは4つ以上のスペースを行頭に書くか、3つずつのバッククオートでコード全体をくくる。
開始を表すバッククオートの3つ目に続けて、任意で言語名を明記することができる。
1行目 2行目 3行目
```javascript(()=>{'use strict';console.log('Hello world');})();```
Markdownは通常、改行や連続したスペースを削除するため、インデントやコードのレイアウトを壊す可能性があるが、この場合Markdownは空白をすべて保持する。
1行の中に、3つ以上のハイフンやアスタリスク・アンダースコアだけを並べると水平線が作られる。ハイフンやアスタリスクのあいだには空白を入れてもよい。以下の行はすべて水平線を生成する。
** *********-- ----------------------------------------
リンクは次のように記述できる。
[リンクのテキスト](リンクのアドレス "リンクのタイトル")
参照目的のリンクとして、脚注として段落外に含めることもできる。
[リンクのテキスト][linkref]
段落外もしくは文書の最後に次のような記述があれば、それは参照リンクとして機能する。
[linkref]:リンクのアドレス "リンクのタイトル"
*強調* もしくは_強調_（斜体として表現されることが多い）**強い強調** もしくは__強い強調__（太字として表現されることが多い）
画像は以下のように埋め込める。リンクの冒頭に ! が付いている形式である。
Markdownが書式化コマンドとして解釈する文字は、バックスラッシュ（U+005C, 日本語環境では円記号として表示される場合もある）を加えることによって、その文字そのものとして解釈させることができる。例えば\* は、テキスト強調の開始ではなくアスタリスクとして出力される。バックスラッシュ自身を出力したい場合は、\\とする。
なお、Microsoft Windowsのファイルシステムではパスの区切り文字にバックスラッシュ\が使われ、ネットワークリソースには2つのバックスラッシュ\\で始まるUNC (Universal Naming Convention) パスが使われる[19]が、Markdownの文書内にそのようなパス文字列を含める場合は配慮が必要である。
生のHTMLのブロックレベル要素の中にあるテキストに対してMarkdownはいかなる変換も行わないので、HTMLのブロックレベル要素のタグでテキストを囲むことによって、Markdownのソース文章の中にHTMLのセクションを加えることもできる。
<font color="red">赤</font>
| 全般 | |
|---|---|
| 国立図書館 | |
