Markdown

Markdown（マークダウン）は、文書を記述するための軽量マークアップ言語のひとつである。本来はプレーンテキスト形式で手軽に書いた文書からHTMLを生成するために開発されたものである。しかし、現在ではHTMLのほかパワーポイント形式やLaTeX形式のファイルへ変換するソフトウェア（コンバータ）も開発されている。各コンバータの開発者によって多様な拡張が施されるため、各種の方言が存在する。 「書きやすくて読みやすいプレーンテキストとして記述した文書を、妥当なXHTML（もしくはHTML）文書へと変換できるフォーマット」として、ジョン・グルーバー（英語版）により作成された。アーロン・スワーツも大きな貢献をしている。Markdownの記法の多くは、電子メールにおいてプレーンテキストを装飾する際の慣習から着想を得ている。 Markdownはグルーバーによって書かれたMarkdown.plというPerlプログラムを指すこともある。このスクリプトは、Markdownの形式でマークアップされたテキストをXHTML文書もしくはHTML文書に変換するものである。Markdown.plはスクリプト単体として利用することができると同時に、BlosxomやMovable Typeのプラグインなどからも利用できる。 Markdown.plは、その後第三者によってCPANのPerlモジュール (Text::Markdown) として再実装され、さらにPython等の他のプログラミング言語でも実装された。MarkdownはBSDライセンスの下で配布され、いくつかのコンテンツ管理システム (CMS) でもプラグインとして利用できる。 有名なMarkdown方言としてCommonMark（英語版）[1]、Markdown Extra（英語版）[2]やGitHub Flavored Markdown（英語版）[3]、Marukuなどがある。その他のサービス・コンバータにおいても表やソースコードの記法などで独自の拡張が加えられていることが多い。以下にMarkdownの利用例を挙げる。 Stack Overflowや他のStack Exchange Networkサイトは、Markdownを改変した方言をデフォルトのフォーマットシステムとして利用している。 PosterousはMarkdownをマークアップの選択肢として提供している。 RedditはMarkdownを利用している。 GitHubはMarkdownの方言をコメント・メッセージ・その他のフォーマットに利用している。John Gruber has described this dialect as a "superior variant" for "situations like user-submitted comments".。のちに、CommonMarkベースの仕様に更新している。 Bitbucketは、README記述用のマークアップ言語の選択肢としてMarkdownを提供している。 Instiki（英語版）はMarkdown拡張を使ってウィキ構文を提供している。この拡張構文はMarukuと呼ばれる。 Squarespaceはブログエントリ記述用のマークアップの選択肢としてMarkdownを提供している。 TumblrはMarkdownでポストを編集できる。 MultiMarkdown（英語版） CommonMark（英語版） StackEdit[4]はオンラインMarkdownエディタの一つ。GitHub Flavored Markdownに、数式記述（MathJaxによる）とUMLシーケンス図、フローチャートを記述できる拡張が加えられている。 以下の例はMarkdownの記法の包括的なリストではないし、ひとつの効果を実現するために複数の記法が利用できる場合も多い。詳細はfull Markdown syntaxに記載されている。 段落は1つ以上の連続したテキストであり、空行によって分けられる。通常の段落をスペースやタブでインデントしてはならない。 これは段落です。2つの文があります。 これは別の段落です。ここにも2つの文があります。 テキストに挿入された改行は最終的な結果から取り除かれる。これは、画面の大きさに応じて改行を行う処理はWebブラウザが担当すべきであるという設計思想による。強制的に改行したい場合は、行末に2つのスペースを挿入すればよい。 HTMLの見出しは、テキストの前にいくつかの'#'を置くことで作ることができる。'#'の数が見出しのレベルに対応する（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]: リンクのアドレス "リンクのタイトル" *強調* もしくは _強調_（斜体として表現されることが多い） **強い強調** もしくは __強い強調__（太字として表現されることが多い） 画像は以下のように埋め込める。リンクの冒頭に ! が付いている形式である。 ![Altのテキスト](/path/to/img.jpg) ![Altのテキスト](/path/to/img.png "タイトル") Markdownが書式化コマンドとして解釈する文字は、バックスラッシュ（U+005C, 日本では円記号に見える環境もある）を加えることによって、その文字そのものとして解釈させることができる。例えば \* は、テキスト強調の開始ではなくアスタリスクとして出力される。 生のHTMLのブロックレベル要素の中にあるテキストに対してMarkdownはいかなる変換も行わないので、HTMLのブロックレベル要素のタグでテキストを囲むことによって、Markdownのソース文章の中にHTMLのセクションを加えることもできる。 <font color="red">赤</font>