LESSON 03
Level 1

Markdown、CSV、JSON

AIと確実にやり取りできる3つの書き方を使い分ける

難易度:入門所要時間:12最終確認日:2026-08-13対象:macOS・Windows
LEARNING GOALS

この教材でできるようになること

  • 資料をAIが読める形に変換する作業をまるごと任せられる
  • 表の集計をCSVで渡して自動で処理してもらえる
  • 他のサービスへ渡すデータをJSONで用意させられる
ONE-PAGE DIAGRAM

一枚図解

同じ内容のメモが、人が読むMarkdown、表として渡すCSV、機械が読むJSONの3つの形に書き分けられ、それぞれ別の届け先へ渡っていく様子を示した図

同じ内容でも、人が読むのか、表として扱うのか、機械が受け取るのかで、ちょうどよい書き方が変わります。書き分けるのはAIの仕事で、あなたは届け先を伝えるだけです。

LESSON

文字による講義

一言で説明

Markdown、CSV、JSONは、どれも「ただの文字だけで書かれた資料」です。特別なソフトがなくても開けるので、AIとのやり取りで最も確実に中身が伝わります。

なぜ必要なのか

見た目を整えた資料は、人には読みやすい一方で、AIには余計な情報が多くなります。表の色や結合されたセル、画面の写真は、意味を読み違える原因になります。文字だけの形にそろえておくと、行と列や項目のつながりがそのまま伝わり、取り違えが起きにくくなります。

身近なたとえ

3つは、相手に合わせた話し方の違いです。Markdownは人に読ませる清書、CSVは表計算ソフトへ渡す台車、JSONは機械同士の受け渡し伝票にあたります。中身は同じでも、渡す相手が変われば包み方が変わる、と考えてください。

どのような仕組みか

Markdownは、記号を少し添えるだけで見出しや箇条書き、表として読める書き方です。CSVは、値をカンマで区切って1行1件を表した表データです。JSONは、項目名と値を組にして入れ子で表せる形で、1件の中にさらに細かい情報を持てます。いずれも、開いてみればただの文字が並んでいるだけです。

AIとの関係

どの形で書くかを覚える必要はありません。 「表にして」「CSVにして」「JSONにして」と伝えれば、AIが書き分けます。人がやるのは、できあがったものを誰に渡すのかを決めることです。届け先を伝えるほど、返ってくる形は用途に合ったものになります。

何ができるか

紙の資料を書き写したメモを整った表に直す、複数のExcelを1枚の一覧に統合する、集計結果を報告書の形に清書する、外部サービスへ送るデータをそろえる、といった仕事を任せられます。

具体例

たとえば手書きの営業メモをそのまま貼って「Markdownの表にして、金額の合計も出して」と頼むと、日付や表記のゆれを直した表が返ります。同じ内容を「CSVでも出して」と頼めば、そのまま表計算ソフトへ取り込めます。

注意点と次に学ぶこと

CSVは見た目の書式や数式を持たないため、Excelの色や関数はそのままでは残りません。元のファイルは上書きせず、別名で保存してください。次は、これらのファイルをまとめて扱うための画面、ターミナルとコマンドを学びます。

USE CASES

実際の利用例

Markdown=人に読ませる清書

議事録や報告書の下書きに向きます。見出しと箇条書きがそろい、そのまま社内共有の文面に使えます。

CSV=表計算ソフトとの橋渡し

Excelやスプレッドシートとの行き来に向きます。集計や並べ替えをAIに任せ、結果を取り込めます。

JSON=機械への受け渡し伝票

チャット通知や外部サービスへ送るデータに向きます。項目名が付いているので、受け取る側が迷いません。

AIへの頼み方例

使い分けは覚えなくて大丈夫です。届け先を書き添えて、次の文をそのまま貼るだけで形が整います。

  • この打ち合わせメモを、決定事項と宿題に分けたMarkdownの議事録にして。社内共有用なので、簡潔にお願いします。

    Markdownで清書させる
  • この一覧を、日付、取引先、金額、担当、入金状況の順のCSVにして。日付の書き方はそろえてください。

    CSVで表を受け取る
  • この内容を、他のサービスへ送れるようにJSONにして。項目名は英語で、意味も1行ずつ説明してください。

    JSONで次の処理へ渡す
HANDS-ON

同じ内容を3つの形に書き分けさせる

このハンズオンのゴール:散らかったメモをAIに渡し、Markdown、CSV、JSONの3つへ変換させて、それぞれの使いどころを説明させる

ファイルを用意する必要はありません。教材に置いた3行のメモをそのまま貼って、同じ内容が3つの形に変わる様子をその場で見てみます。

散らかったメモを3つの形に整えてもらう
私は非エンジニアです。次のメモを、Markdown、CSV、JSONの3つの形に書き直してください。

4月12日 山田商事 見積提出 30万円 担当佐藤 未入金
4/15 鈴木工業 契約済み 12万 担当田中 入金済
四月二十日 高橋製作所 見積中 金額未定 担当佐藤

次の順で答えてください。

1. 日付や金額の書き方がそろっていない箇所の指摘
2. Markdownの表として書いたもの
3. CSVとして書いたもの
4. JSONとして書いたもの
5. それぞれをどんな場面で使うとよいかを、1行ずつ

専門用語には短い言い換えを添えてください。

期待される結果

表記のゆれの指摘に続いて、同じ3件が表、カンマ区切り、項目名つきの3つの形で並びます。

成功条件

自分の手元の資料について「これはどの形で受け取るとよいか」を1つ選べれば成功です。

注意点

実在の取引先名や金額は入れません。まずは教材のサンプルのままで試してください。

分かりにくかったとき

「3つの違いを、私の仕事のたとえで説明してください」とAIへ追加で伝えます。

TROUBLESHOOTING

エラーまたは失敗例

CSVを開いたら列がずれていたら、値の中のカンマを疑います。

CSVはカンマで列を区切るため、会社名や住所のように値そのものにカンマが含まれていると、そこで列が分かれてしまいます。1件だけ列数が多い行がある、金額の欄に住所の一部が入っている、といった形で現れます。ずれている行をそのままAIへ渡し、「値の中のカンマを正しく扱う形で出し直してください」と伝えれば直せます。手で1件ずつ直すと、直したつもりの取り違えが残ります。

SAFETY

安全上の注意

文字だけの形は、中身がそのまま読めます。

  • CSVやJSONに顧客名、連絡先、金額が入ったまま貼ると、その内容をAIサービスへ渡すことになります。社内の決まりを先に確かめてください。
  • APIキーやパスワードを、設定用のJSONへ書いたまま共有したり貼ったりしないでください。
  • 元のExcelを上書き保存すると、色や数式が失われる場合があります。変換結果は別名で保存します。

ここだけは人間がやる

AIに任せない

変換も整形もAIに任せられますが、次の3つはあなたが決めます。

  • 渡してよい情報かの判断 — 個人情報や社外秘を含むデータをAIへ渡すかどうか。
  • 元ファイルの上書き・削除の承認 — 何がどう変わるかをAIに説明させてから「進めて」と答える。
  • 最終確認 — できあがった表や文書を人の目で見て、社内や取引先へ出してよいかを決める。

AIにこう聞いてみよう

3つの形の違いがつかめたね。次は「自分の資料はどれ?」を僕に聞いてみよう。下の文をコピーして、そのまま貼るだけでいいよ!
AIへ入力する指示
私の資料は、どの形であなたに渡すのがいい?

私は非エンジニアです。まず、私がふだん作っている資料について質問を3つほどして、内容をつかんでください。そのうえで、Markdown、CSV、JSONのどれで渡すとよいかを、理由と一緒に専門用語なしで教えてください。

迷ったときは「私はこの資料を誰に見せたいのか」を書き添えると、ちょうどよい形を選んでもらえます。

形の名前は覚えなくていいよ。「誰に渡すか」だけ教えてくれれば、あとは僕が書き分けるからね!

CHECK

確認問題

問題 1 / 3 未回答

Excelで作った表をAIに集計させたい。最も確実な渡し方はどれか。

Excelで作った表をAIに集計させたい。最も確実な渡し方はどれか。

問題 2 / 3 未回答

AIの出力を他のサービスへそのまま渡して自動処理させたい。適した形はどれか。

AIの出力を他のサービスへそのまま渡して自動処理させたい。適した形はどれか。

問題 3 / 3 未回答

AIが作ったCSVをExcelで開いたら文字化けした。最初に行うべきことはどれか。

AIが作ったCSVをExcelで開いたら文字化けした。最初に行うべきことはどれか。
ログインすると、回答した記録がダッシュボードに残ります

ログインしなくても、確認問題には何度でも回答できます。

YOUR WORK

自分の仕事へ置き換えてみる

入力する情報、実行する時刻、結果の届け先、人が確認する場面まで書くと、仕組みを設計しやすくなります。

PROMPT CARD

実務で使えるプロンプト

散らかったメモを3つの形に整えてもらう
私は非エンジニアです。次のメモを、Markdown、CSV、JSONの3つの形に書き直してください。

4月12日 山田商事 見積提出 30万円 担当佐藤 未入金
4/15 鈴木工業 契約済み 12万 担当田中 入金済
四月二十日 高橋製作所 見積中 金額未定 担当佐藤

次の順で答えてください。

1. 日付や金額の書き方がそろっていない箇所の指摘
2. Markdownの表として書いたもの
3. CSVとして書いたもの
4. JSONとして書いたもの
5. それぞれをどんな場面で使うとよいかを、1行ずつ

専門用語には短い言い換えを添えてください。
クリア!
COMPLETE

学んだことを、自分の言葉で説明できそうですか?

完了を記録すると、無料アカウントの学習ダッシュボードからいつでも振り返れます。

次の教材: ターミナルとコマンド