Markdown“Markdown は John Gruber が 2004 年に考案した軽量マークアップ言語です。読み書きしやすいプレーンテキストで文書を作成できます。変換ツールを使えば、Markdown の文書を HTML、Word、画像、PDF、EPUB などの形式に出力できます。文書の拡張子は通常 .md または .markdown です。Markdown の応用GitBook などのツールを使い、Markdown で電子書籍を書くこともできます。GitHub、簡書、Reddit、Diaspora、Stack Exchange、OpenStreetMap、SourceForge など、多くのサイトがドキュメントやフォーラムの投稿に Markdown を使っています。Markdown の基本構文見出し | TitleMarkdown の見出しには 2 つの形式があります。1. = と - でレベル 1・2 の見出しを作るMarkdownコピーH1 の見出し =========== H2 の見出し -----------2. # を使う行頭の # の数で、レベル 1~6 の見出しを表します。レベル 1 は # 1 つ、レベル 2 は # 記号 2 つ、以下同様です。Markdownコピー# レベル 1 の見出し ## レベル 2 の見出し ### レベル 3 の見出し #### レベル 4 の見出し ##### レベル 5 の見出し ###### レベル 6 の見出し段落 | Paragraph段落に特別な記法は必要ありません。そのまま文章を書けます。段落内で改行するには、行末に半角スペースを 2 つ以上入れて Enter キーを押します。段落の間に空行を入れると、別の段落になります。斜体と太字 | Phrase EmphasisMarkdown では *テキスト* または _テキスト_ で斜体を、**テキスト** または __テキスト__ で太字を表します。用法表示*斜体テキスト*斜体テキスト_斜体テキスト_斜体テキスト**太字テキスト**太字テキスト__太字テキスト__太字テキスト***太字斜体テキスト***太字斜体テキスト___太字斜体テキスト___太字斜体テキストリスト | ListMarkdown は順序なしリストと順序付きリストをサポートしています。順序なしリスト順序なしリストでは、アスタリスク* やプラス記号+、またはマイナス記号- を使います。記号の後に半角スペースを 1 つ入れてから、項目の内容を書きます。Markdownコピー* 1つ目の項目 * 2つ目の項目 * 3つ目の項目 + 1つ目の項目 + 2つ目の項目 + 3つ目の項目 - 1つ目の項目 - 2つ目の項目 - 3つ目の項目順序付きリスト順序付きリストは数字と . 記号を使って表します。例:Markdownコピー1. 1つ目の項目 2. 2つ目の項目 3. 3つ目の項目リストの入れ子リストの入れ子は、子リストの項目の前に半角スペース 4 つを追加するだけです:Markdownコピー1. 1つ目の項目: - 1つ目の項目にネストした1つ目の要素 - 1つ目の項目にネストした2つ目の要素 2. 2つ目の項目: - 2つ目の項目にネストした1つ目の要素 - 2つ目の項目にネストした2つ目の要素ブロック引用 | BlockquotesMarkdown のブロック引用では、段落の先頭に > を置き、その後に 空白 を入れます。Markdownコピー>Hi, this is xxxbrian. >Brian's Blog >等青春轻飘的烟雾把少年的欢乐袅袅曳去,之后,我们就能取得一切值得吸取的东西。 ——普希金また、ブロックは入れ子にできます。1 つの > 記号が最外層、2 つの > 記号が第 1 層の入れ子で、以下同様です:Markdownコピー> 外側 > > 1段目の入れ子 > > > 2段目の入れ子ブロック内でリストを使用Markdownコピー> 引用内でリストを使う > 1. 1つ目の項目 > 2. 2つ目の項目 > + 1つ目の項目 > + 2つ目の項目 > + 3つ目の項目リスト内でブロックを使用Markdownコピー+ 1つ目の項目 > Brian's Blog > Hi, this is xxxbrian. + 2つ目の項目コード | Code段落内の関数名やコード片は、バッククォート` で囲みます。たとえば `コード` のように書きます。関数名 printf() を表示する例です。Markdownコピー`printf()` 関数コードブロックコードブロックは、行頭に スペース 4 つ またはタブ文字を 1 つ入れて記述します。Markdownコピー$(document).ready(function () { alert('RUNOOB'); });表示結果は次のとおりです: $(document).ready(function () { alert('RUNOOB'); });また、```でコードを囲み、言語を指定することもできます(指定しなくてもかまいません):JavaScriptコピー$(document).ready(function () { alert('RUNOOB'); });表示結果は次のとおりです:JavaScriptコピー$(document).ready(function () { alert('RUNOOB'); });ハイパーリンク | Linkリンク の使用方法は次のとおりです:Markdownコピー[リンクテキスト](リンク先) または <リンク先>例:Markdownコピーこれはリンクです [Brian's Blog](https://xxxbrian.me)リンクの例:Brian's Blogリンクアドレスを直接使用するMarkdownコピーリンク <https://xxxbrian.me>リンク <https://xxxbrian.me>参照形式のリンク参照形式では、本文中のリンクにラベルを付け、対応する URL を文書の末尾などにまとめて定義できます。Markdownコピーこのリンクは 1 を参照ラベルに使います [Google][1] このリンクは Brian's Blog を参照ラベルに使います [xxxbrian][xxxbrian] [1]: http://www.google.com/ [xxxbrian]: https://xxxbrian.me画像 | ImagesMarkdown の画像構文は次のとおりです:Markdownコピー 先頭に感嘆符 !続けて角括弧の組の中に画像の代替テキストを書きます。丸括弧の組の中に画像の URL を書き、必要であれば引用符で囲んだ 'title' を追加します。使用例:Markdownコピー表 | TablesMarkdown で表を作成するには、| で異なるセルを区切り、- で表ヘッダーとその他の行を区切ります。Markdownコピー| ヘッダー | ヘッダー | | ---- | ---- | | セル | セル | | セル | セル |表の整列-: は、内容と見出しを右揃えに設定します。:- は、内容と見出しを左揃えに設定します。:-: は、内容と見出しを中央揃えに設定します。Markdownコピー| 左揃え | 右揃え | 中央揃え | | :-----| ----: | :----: | | セル | セル | セル | | セル | セル | セル |エスケープ | Backslash EscapesMarkdown では多くの特殊記号を特定の意味を表すために使用しています。特定の記号を表示する必要がある場合はエスケープ文字を使用します。Markdown ではバックスラッシュで特殊文字をエスケープします:Markdownコピー**太字** \*\* アスタリスクをそのまま表示 \*\*Markdown では、次の記号の前にバックスラッシュを付けることで、通常の記号として挿入できます:TEXTコピー\ バックスラッシュ ` バッククォート * アスタリスク _ アンダースコア {} 波括弧 [] 角括弧 () 丸括弧 # ハッシュ記号 + プラス記号 - マイナス記号 . ピリオド ! 感嘆符
Markdown
Markdown の応用
GitBook などのツールを使い、Markdown で電子書籍を書くこともできます。
GitHub、簡書、Reddit、Diaspora、Stack Exchange、OpenStreetMap、SourceForge など、多くのサイトがドキュメントやフォーラムの投稿に Markdown を使っています。
Markdown の基本構文
見出し | Title
Markdown の見出しには 2 つの形式があります。
1. = と - でレベル 1・2 の見出しを作る
2. # を使う
行頭の # の数で、レベル 1~6 の見出しを表します。レベル 1 は # 1 つ、レベル 2 は # 記号 2 つ、以下同様です。
段落 | Paragraph
段落に特別な記法は必要ありません。そのまま文章を書けます。段落内で改行するには、行末に半角スペースを 2 つ以上入れて Enter キーを押します。
段落の間に空行を入れると、別の段落になります。
斜体と太字 | Phrase Emphasis
Markdown では *テキスト* または _テキスト_ で斜体を、**テキスト** または __テキスト__ で太字を表します。
用法
表示
*斜体テキスト*
斜体テキスト
_斜体テキスト_
斜体テキスト
**太字テキスト**
太字テキスト
__太字テキスト__
太字テキスト
***太字斜体テキスト***
太字斜体テキスト
___太字斜体テキスト___
太字斜体テキスト
リスト | List
Markdown は順序なしリストと順序付きリストをサポートしています。
順序なしリスト
順序なしリストでは、アスタリスク* やプラス記号+、またはマイナス記号- を使います。記号の後に半角スペースを 1 つ入れてから、項目の内容を書きます。
順序付きリスト
順序付きリストは数字と . 記号を使って表します。例:
リストの入れ子
リストの入れ子は、子リストの項目の前に半角スペース 4 つを追加するだけです:
ブロック引用 | Blockquotes
Markdown のブロック引用では、段落の先頭に > を置き、その後に 空白 を入れます。
また、ブロックは入れ子にできます。1 つの > 記号が最外層、2 つの > 記号が第 1 層の入れ子で、以下同様です:
ブロック内でリストを使用
リスト内でブロックを使用
コード | Code
段落内の関数名やコード片は、バッククォート` で囲みます。たとえば `コード` のように書きます。関数名 printf() を表示する例です。
コードブロック
コードブロックは、行頭に スペース 4 つ またはタブ文字を 1 つ入れて記述します。
表示結果は次のとおりです:
$(document).ready(function () {
alert('RUNOOB');
});
また、```でコードを囲み、言語を指定することもできます(指定しなくてもかまいません):
表示結果は次のとおりです:
ハイパーリンク | Link
リンク の使用方法は次のとおりです:
例:
リンクの例:Brian's Blog
リンクアドレスを直接使用する
リンク <https://xxxbrian.me>
参照形式のリンク
参照形式では、本文中のリンクにラベルを付け、対応する URL を文書の末尾などにまとめて定義できます。
画像 | Images
Markdown の画像構文は次のとおりです:
使用例:
表 | Tables
Markdown で表を作成するには、| で異なるセルを区切り、- で表ヘッダーとその他の行を区切ります。
表の整列
エスケープ | Backslash Escapes
Markdown では多くの特殊記号を特定の意味を表すために使用しています。特定の記号を表示する必要がある場合はエスケープ文字を使用します。Markdown ではバックスラッシュで特殊文字をエスケープします:
Markdown では、次の記号の前にバックスラッシュを付けることで、通常の記号として挿入できます: