Markdown記法を使うことで、プレーンテキストでも見出し、リスト、強調表示などの書式が簡単に付けられます。

これにより、Readmeファイルがより美しく、読みやすくなります。

GitHubでは、ファイルの変更履歴を管理するためのバージョン管理システムを提供しています。

Markdown記法を使うことで、テキスト形式での変更が容易になります。

また、テキスト形式であるため、変更の差分がわかりやすくなります。

Markdown記法は、コードの表示にも適しています。

コードブロックを作成することができ、言語の種類を指定することもできます。

これにより、コードの表示が美しく、読みやすくなります。

GitHubのReadmeファイルは、プロジェクトの説明や使用方法を提供するため、検索エンジンの検索結果に表示されることがあります。

Markdown記法を使うことで、適切な見出しやキーワードを使用することができ、SEOに有効な文章を作成することができます。

README.mdというファイルをプロジェクトのルートディレクトリに作成します。

拡張子は.mdであることに注意してください。

作成したREADME.mdを、お好みのテキストエディタで開いてください。

後術するMarkdown記法を使って、README.mdにテキストを書きます。

見出し、段落、リスト、コードブロック、引用など、必要に応じて適切な要素を使用してください。

テキストを書き終えたら、ファイルをコミットしてGitHubにプッシュします。

コミットメッセージには、README.mdファイルを更新した旨を記載してください。

プッシュしたREADME.mdをGitHub上で確認しましょう。

フォーマットが正しいか、リンクや画像が正しく表示されているか、確認してください。

#から######までのハッシュタグで表現できます。

# 見出し1
## 見出し2
### 見出し3
#### 見出し4
##### 見出し5
###### 見出し6

で画像を表示できます。

![ER図](ER.png)

|で区切ってテーブルを作成できます。

カラムA | カラムB | カラムC
--- | --- | ---
内容A1 | 内容B1 | 内容C1
内容A2 | 内容B2 | 内容C2
内容A3 | 内容B3 | 内容C3

```でコードブロックを作成できます。

また、言語の種類を指定することもできます。

```ruby
class ApplicationController < ActionController::Base
  # code sample
end
```

`でインラインコードを作成できます。

インラインコードは ` このように`表示されます。

折り畳みを作成するには、以下のように書きます。

<details>
<summary>ここをクリック</summary>
aaaaaaaaaaaaaaaaaaa<br>
bbbbbbbbbbbbbbbbbbb<br>
ccccccccccccccccccccc<br>
</details>

数式を表示するには、以下のように書きます。

$x = {-b \pm \sqrt{b^2-4ac} \over 2a}$

$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}$$

空行で段落を区切ることができます。

段落１

段落２

行末にスペースを2つ入れることで改行できます。

一行目  
二行目

---または___で水平線を作成できます。

---

箇条書きと番号付きのリストを作成することができます。

・箇条書き

- aaa
  - 111
  - 222
  - 333
    - あああ
    - いいい
    - ううう
- bbb
- ccc

・番号付き

1. aaa
   1. 111
   2. 222
   3. 333
      1. あああ
      2. いいい
      3. ううう
2. bbb
3. ccc

チェックボックスを作成することができます。

- [ ] aaa
- [x] bbb
- [ ] ccc

*または_で囲んで表現します。

ただし、日本語の場合、一部のフォントでは斜体が正しく表示されないことがあります。

This is *italic* text.  
これは*斜体*です

This is **bold** text.  
これは**太字**です

This is ***italic&bold*** text.  
これは***太字の斜体***です

This is ~~strikethrough~~ text.  
これは~~取り消し線~~です

>で引用を表現できます。

> 引用
>> 引用の中で引用

[リンクのテキスト](URL)でリンクを作成できます。

[リンク](https://www.google.com/)