Markdown は、軽量で簡単に学習できるマークアップ言語です。文章を記述する際にシンプルな記法を使用し、HTMLや他のフォーマットへの変換を容易にします。主にブログ、ドキュメント、READMEファイル、技術文書で使用されます。本ハンドブックでは、Markdownの基本記法から応用テクニックまで幅広く解説します。
Markdownの主な特徴は次の通りです:
Markdownは、2004年にJohn Gruberによって作られたマークアップ言語です。以下の目的で設計されました:
Markdownは多くのツールやプラットフォームで採用されており、簡単にHTMLやPDFに変換できます。
# を使うことで見出しを作成できます。
# 見出し1## 見出し2### 見出し3
<h1class="code-line"data-line-start=0data-line-end=1><aid="1_0"></a>見出し1</h1><h2class="code-line"data-line-start=1data-line-end=2><aid="2_1"></a>見出し2</h2><h3class="code-line"data-line-start=2data-line-end=3><aid="3_2"></a>見出し3</h3>
文字を強調する方法は以下の通りです:
**太字** または__太字__*斜体* または_斜体_これは**太字** と*斜体* の例です。
<pclass="has-line-data"data-line-start="0"data-line-end="1">これは<strong>太字</strong> と<em>斜体</em> の例です。</p>
- または* を使用します。-項目1-項目2-サブ項目1-サブ項目21. 手順A2. 手順B1. サブ手順α2. サブ手順β
<ul><liclass="has-line-data"data-line-start="0"data-line-end="1">項目1</li><liclass="has-line-data"data-line-start="1"data-line-end="5">項目2<ul><liclass="has-line-data"data-line-start="2"data-line-end="3">サブ項目1</li><liclass="has-line-data"data-line-start="3"data-line-end="5">サブ項目2</li></ul></li></ul><ol><liclass="has-line-data"data-line-start="5"data-line-end="6">手順A</li><liclass="has-line-data"data-line-start="6"data-line-end="9">手順B<ol><liclass="has-line-data"data-line-start="7"data-line-end="8">サブ手順α</li><liclass="has-line-data"data-line-start="8"data-line-end="9">サブ手順β</li></ol></li></ol>
[リンクテキスト](URL)[Google](https://www.google.com)
<pclass="has-line-data"data-line-start="0"data-line-end="1"><ahref="https://www.google.com">Google</a></p><pclass="has-line-data"data-line-start="2"data-line-end="3"><imgsrc="https://example.com/image.png"alt="サンプル画像"></p>
インラインコードはバッククォート` ` を使います。複数行のコードブロックは3つのバッククォートで囲みます。
文中に`インラインコード`を含めることが出来ます。複数行コードブロック```function hello() { console.log("Hello, World!");}```
<pclass="has-line-data"data-line-start="0"data-line-end="1">文中に<code>インラインコード</code>を含めることが出来ます。</p><pclass="has-line-data"data-line-start="2"data-line-end="3">複数行コードブロック</p><pre><codeclass="has-line-data"data-line-start="4"data-line-end="8">function hello() { console.log("Hello, World!");}</code></pre>
引用は> を使います。
>これは引用です。引用は段落を単位に行われるので、次の空行までが引用になります。
<blockquote><pclass="has-line-data"data-line-start="0"data-line-end="2">これは引用です。<br> 引用は段落を単位に行われるので、次の空行までが引用になります。</p></blockquote>
水平線は--- または*** を使用します。
---
<hr>
Markdownの基本記法に加えて、拡張記法を使うことでさらなる機能を利用できます。これには以下が含まれます:
| 列1 | 列2 | 列3 ||-----|-----|-----|| 値1 | 値2 | 値3 || 値a | 値b | 値c |
<tableclass="table table-striped table-bordered"><thead><tr><th>列1</th><th>列2</th><th>列3</th></tr></thead><tbody><tr><td>値1</td><td>値2</td><td>値3</td></tr><tr><td>値a</td><td>値b</td><td>値c</td></tr></tbody></table>
- [x] 完了項目- [ ] 未完了項目
<ul><liclass="has-line-data"data-line-start="0"data-line-end="1"><inputtype="checkbox"id="checkbox0"checked="true"><labelfor="checkbox0">完了項目</label></li><liclass="has-line-data"data-line-start="1"data-line-end="2"><inputtype="checkbox"id="checkbox1"><labelfor="checkbox1">未完了項目</label></li></ul>
GitHubでは以下のような追加記法が使用可能です:
```python)Markdownを編集する際に便利なツールやエディタを紹介します。
$pandocinput.md-ooutput.html
Markdownを活用した応用テクニックを紹介します。
MarkdownをHTMLに変換してWebページを作成できます。
スタイルを適用して見栄えの良いドキュメントを作成。
Markdownを使って以下の構造の文書を作成してください:
GitHub Flavored Markdownを使って、チェックリストとテーブルを含むMarkdown文書を作成してください。