12  Markdown入門

Markdown（マークダウン）は，文書を記述するための軽量マークアップ言語の一つです．Markdown記法は，シンプルで読み書きが容易でありながら，HTMLなどのマークアップ言語に変換することができます．Markdown記法は，John GruberとAaron Swartzによって設計され，2004年にリリースされました．

Markdownは、ブログ記事、READMEファイル、ドキュメントなど、さまざまな用途で広く使用されています。現在，生成AIの発展に伴い，Markdownはさらに重要な役割を果たしています．

12.1 VS CodeでMarkdownファイルの作成

VS Codeを使用してMarkdownファイルを作成するには，以下の手順に従います．

  1. VS Codeを開きます．
  2. 「ファイル」メニューから「フォルダを開く」を選択し，Markdownファイルを保存したいフォルダを選択します．
  3. 「ファイル」メニューから「新しいファイル」を選択します．
  4. ファイル名を入力し，拡張子を .md にします．例えば，notes.md とします．
  5. Ctrl + S を押してファイルを保存します．
  6. Markdownファイルが作成され，VS Codeのエディタで開かれます．

まずは，以下の内容をMarkdownファイルにコピーしてみましょう．

# Level 1 Heading

This is a *sample* **Markdown** file.

## Level 2 Heading

- Item 1
- Item 2

## Equation

$$
E = mc^2
$$

よく使用されるMarkdownの記号を以下の表に示します．

記号 説明
# 見出し（レベル1）
## 見出し（レベル2）
- 箇条書き
1. 番号付き箇条書き
** 太字
* 斜体
> 引用
` コード

12.2 見出し

# の後にスペースを空けてテキストを書くことで，見出しを作成できます．# の数によって見出しのレベルが決まります．例えば，レベル3の見出しは，### を使用します．

# 見出し1
## 見出し2
### 見出し3

12.3 段落

段落は，空行で区切ることで作成できます．

Markdownが大好きです．

これから，Markdownで講義ノートを書いていきます．

12.4 太字

** でテキストを囲むと，太字になります．

Markdownが**大好き**です．

Markdownが大好きです．

12.5 イタリック

* でテキストを囲むと，イタリックになります．

*Markdown*が大好きです．

Markdownが大好きです．

12.6 引用

> を文の前に置くと，引用になります．

> 学而不思則罔，思而不学則殆．
>
> -- 孔子

学而不思則罔，思而不学則殆．

– 孔子

12.7 リスト

順序なしリストは，- を使用して作成できます．

- 項目1
- 項目2
- 項目3
  • 項目1
  • 項目2
  • 項目3

順序ありリストは，1. のように数字とピリオドを使用して作成できます．

1. 項目1
2. 項目2
3. 項目3
  1. 項目1
  2. 項目2
  3. 項目3

12.8 コード

本文の内容をコードとして表示するには，バッククォート（```）でテキストを囲みます．

以下は，Pythonのコードブロックの例です．

```python
print("Hello, World!")
```
print("Hello, World!")

以下は，C言語のコードブロックの例です．

```c
#include <stdio.h>
int main() {
    printf("Hello, World!\n");
    return 0;
}
```
#include <stdio.h>
int main() {
    printf("Hello, World!\n");
    return 0;
}

12.9 数式

$で囲むことでインライン数式（inline equation）を記述することができる．例えば，$y = ax + b$ は，\(y = ax + b\)と表示される．

$$で囲むことでディスプレイ数式（display equation）を記述することができる．例えば，$$y = ax + b$$ は，

\[y = ax + b\]

と表示される．