超初心者向け マークダウンの書き方

プログラミングを勉強するのにたくさんのブログ記事を読むことになりますが、プログラミングの世界では、文章を書くときにマークダウン記法で書くことが一般的です。マークダウン記法とは、簡単に文章の形を整えて読みやすい形にすることのできる記法です。また多くの人が、プログラミングを勉強する過程で、ブログを書いて、発信していくことが大切だと言っています。そこで今回は、これからプログラミングの勉強を始める人に向けて、マークダウン記法について解説したいと思います。ぜひ皆さんも私と一緒にプログラミングを勉強しながらブログで記事を書いていきましょう。

**目次**
---
1. [タイトルの書き方](#タイトルの書き方)
1. [太文字の書き方](#太文字の書き方)
1. [斜体文字の書き方](#斜体文字の書き方)
1. [打ち消し線の書き方](#打ち消し線の書き方)
1. [リストの書き方](#リストの書き方)
    1. [順序なしリスト](#順序なしリスト)
    1. [番号付きリスト](#番号付きリスト)
1. [チェックボックス](#チェックボックス)
1. [引用の書き方](#引用の書き方)
1. [水平線の書き方](#水平線の書き方)
1. [リンク](#リンク)
1. [タイトル付きリンク](#タイトル付きリンク)
1. [ページ内リンク](#ページ内リンク)
1. [インラインコード](#インラインコード)
1. [コードブロック](#コードブロック)
1. [イメージ](#イメージ)
1. [テーブル](#テーブル)
1. [補足説明](#補足説明)
1. [参考](#参考)

# Qiitaでアカウントを作ろう
Qiitaは、プログラマー向けのブログサイトで、マークダウン記法で文章を書くことができます。マークダウン記法に慣れるにも、ブログを書くにも向いているので、Qiitaでアカウントを作って皆さんもブログを書いてみてください。

今回紹介しているMarkdownは、Qiitaで使えるものですが、サイトやサービスによっては使えないものや、独自のものが開発されている場合もあります。

[`Qiita`](https://qiita.com)


# タイトルの書き方
`#`の後にスペースキーを押すと大見出し、Heading1になります。
`##`の後にスペースキーを押すと中見出し、Heading2になります。
このように、`#` の数を1~6まで増やしていくと、Heading1~Heading6まで、
を書くことができます。

```html:書き方
# 大見出し Heading1
## 中見出し Heading2
### 小見出し Heading3
...
###### Heading6

```

**結果**
# Heading1
## Heading2
### Heading3
#### Heading4
##### Heading5
###### Heading6

# 太文字の書き方
太文字にしたい文字の両側に`*`を2つ入力すると**太文字**を書くことができます。
```html:書き方
**太文字**
__太文字__
```
**結果**
**太文字**
__太文字__

# 斜体文字の書き方
斜体にしたい文字の両側に`*`を1つ入力すると*斜体文字*を書くことができます。

```html:書き方
*斜体文字*
_斜体文字_
```
**結果**
*斜体文字*
_斜体文字_

# 打ち消し線の書き方
打ち消し線を使いたい文字の両側に`~`を2つ入力します。

```html:書き方
~~打ち消し線~~
```
**結果**
~~打ち消し線~~

\*斜体ではなくなる\*


# リストの書き方

## 順序なしリスト
`-`を入力して、スペースキーを押すとリストができます。

```html:書き方
- リスト
- リスト
- リスト
    - リスト
    - リスト
```
**結果**
- リスト
- リスト
- リスト
    - リスト
    - リスト

## 番号付きリスト
`1.`を入力して、スペースキーを押すとリストができます。

```html:書き方
1. リスト1
1. リスト2
1. リスト3
```
**結果**
1. リスト1
1. リスト2
1. リスト3

# チェックボックス
`- [ ]`を入力してスペースキーを押すとチェックボックスが作れます。チェックが入った状態にするには、`-[x]`を入力します。

```html:書き方
- [ ] タスク1
- [x] タスク2
```
**結果**
- [ ] タスク1
- [x] タスク2

# 引用の書き方
`>`を文頭に入力すると引用になります。
```html:書き方
> 文頭に入力します。
> 引用になります。
```
**結果**
> 文頭に入力します。
> 引用になります。

# 水平線の書き方
`-`を3つ入力すると水平線が入ります。
```html:書き方
---
___
```
**結果**

---
___

# リンク

```html:書き方
[Markdown記法 チートシート - Qiita](https://qiita.com/Qiita/items/c686397e4a0f4f11683d)
```
**結果**
[Markdown記法 チートシート - Qiita](https://qiita.com/Qiita/items/c686397e4a0f4f11683d)

# タイトル付きリンク
```html:書き方
[Markdown記法 チートシート - Qiita](https://qiita.com/Qiita/items/c686397e4a0f4f11683d "Markdown チートシート")
```
**結果**
[Markdown記法 チートシート - Qiita](https://qiita.com/Qiita/items/c686397e4a0f4f11683d "Markdown チートシート")

# ページ内リンク
```html:書き方
[リスト](#リスト)
```
**結果**
[リスト](#リスト)

# インラインコード
```html:書き方
`コード`
```
**結果**
`コード`

# コードブロック
```html:書き方
    ```
    コードブロック
    ```
```
**結果**
```
コードブロック
```

# イメージ
```html:書き方
![タイトル](URL)
![Markdown Logo](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)
```
**結果**
![Markdown Logo](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)


# テーブル
```html:書き方
| 名前   | Email     |
| ----- | --------- |
| Qiita | qiita.com |

```
**結果**
| 名前   | Email     |
| ----- | --------- |
| Qiita | qiita.com |

**中央揃え**
```html:書き方
| 名前   | Email     |
| :-----: | :---------: |
| Qiita | qiita.com |

```
**結果**
| 名前   | Email     |
| :-----: | :---------: |
| Qiita | qiita.com |

**左揃え**
```html:書き方
| 名前   | Email     |
| :----- | :--------- |
| Qiita | qiita.com |

```
**結果**
| 名前   | Email     |
| :----- | :--------- |
| Qiita | qiita.com |

**右揃え**
```html:書き方
| 名前   | Email     |
| -----: | ---------: |
| Qiita | qiita.com |

```
**結果**
| 名前   | Email     |
| -----: | ---------: |
| Qiita | qiita.com |

# 補足説明
補足説明を入れる場合は、`:::note info`と`:::`で囲みます。`info`を`warn`や`alert`に変えて別のメッセージにすることもできます。

```html:書き方
:::note info
インフォメーション
:::

:::note warn
警告
:::

:::note alert
より強い警告
:::
```

**結果**

:::note info
インフォメーション
:::

:::note warn
警告
:::

:::note alert
より強い警告
:::

# 参考

https://qiita.com/Qiita/items/c686397e4a0f4f11683d

https://dotinstall.com/lessons/basic_markdown_v3

https://www.youtube.com/watch?v=bTVIMt3XllM

https://www.youtube.com/watch?v=HUBNt18RFbo