はじめに

Markdownは、シンプルな記号を使って文章を装飾できる書き方のルールです。

プログラマー向けのイメージがありますが、実際には：

• Claude / ChatGPT …etcへのプロンプト

• Substackの記事

• Lark のドキュメント・Wikiページ

• GitHub の README

• Notion のページ

これら全部で使えます。
かつ、AIに読んでもらうにはこれでまとめた.mdファイルの方が理解してくれやすいので、覚えておくと、作業効率が一気に上がります！

見出し（Heading）

# 大見出し
## 中見出し
### 小見出し

表示例

大見出し

中見出し

小見出し

# の数が増えるほど小さくなります。
記事の構成を作るときに使います。

太字・斜体・打ち消し線

**太字**
*斜体*
~~打ち消し線~~

表示例

これが太字　これが斜体　これが打ち消し線

強調したいキーワードに ** を使うのが一番よく使います。

箇条書きリスト（Unordered List）

- りんご
- みかん
- バナナ

または

* りんご
* みかん
* バナナ

copy

表示例

• りんご

• みかん

• バナナ

- か * どちらでも同じ。個人的に - の方が打ちやすいので - 派かな。

番号付きリスト（Ordered List）

1. 準備する
2. 実行する
3. 確認する

表示例

1. 準備する

2. 実行する

3. 確認する

手順や順序がある内容はこちら。

チェックボックス（Task List）

- [ ] 未完了のタスク
- [x] 完了したタスク

表示例（noteだと表示されないっぽい！）

引用（Blockquote）

> これは引用文です。
> 複数行にわたる引用は、各行に > をつけます。

表示例

名言・資料からの引用・強調したいメッセージに使います。

コードブロック

```
ここにコードを書く
複数行OK
```

言語を指定するとシンタックスハイライトがかかります：

```python
def hello():
    print("Hello, World!")
```

表示例

def hello():
    print("Hello, World!")

AIへのプロンプトにコードを渡すときにも使うと整理されます。

水平線（区切り線）

---

または

***

表示例

セクションの区切りに使います。記事の構成を視覚的に整理できます。

表（Table）

| 項目 | 内容 | 備考 |
|------|------|------|
| A    | 100  | 済み |
| B    | 200  | 未完 |

表示例

よく使う組み合わせパターン

AIへのプロンプトを整理するとき

## 依頼内容
〇〇をしてください。

## 条件
- 文字数：500字以内
- トーン：やわらかく
- 対象：非エンジニア

## 出力形式
| 項目 | 内容 |
|------|------|

手順書・マニュアルを書くとき

## セットアップ手順

1. リポジトリをクローンする
   ```bash
   git clone https://github.com/xxx

おわりに

Markdownは覚えることが少ない割に、使える場面がかなり広いです。

特に最近は「フォルダ構造を Markdownファイルで整理する」だけで、トークン消費と回答の質がかなり変わることもあります。
そこがなかなか難しいんだけどねー
※HTMLの方が視覚的にも見やすくオススメされることもあります

まずは `##`（見出し）と `-`（箇条書き）との2つだけでも使ってみてください！
それだけで、伝わり方が変わりますよー！

「しゅんのAI実践ログ」をお読みいただきありがとうございます！
色々AI関連の試行錯誤を発信していくのでぜひ購読お願いします！