Claude Code で地味に効くのに、みんな後回しにするのがこれだ。
最初に「Markdown で返すのか、表で返すのか」を決めないまま投げると、あとで整形し直す羽目になる。内容は合っているのに、出力がバラけていてそのまま使えない。あれはかなりだるい。
たとえば議事録、ファイル一覧、比較表、手順書。どれも似ているようで、欲しい形は違う。ここを曖昧にすると、Claude Code はそれなりに頑張ってしまうが、こちらの用途には微妙に噛み合わない返答を返しやすい。逆に、先に形式を固定すると、同じ材料でもぐっと使いやすくなる。Markdown か表かを決める、出力形式を指定する。たったそれだけで、手戻りが減る。
いちばん簡単なのは、依頼文の最初に「出力形式」を書くことだ。Claude Code に作業を頼むとき、いきなり中身から入らない。まず箱を決める。
次の内容を、Markdown の見出しと箇条書きで返してください。
表にはしないでください。
対象: 契約書レビューのメモ
出力したい項目: 論点、気になる表現、確認先、次にやること
逆に、一覧性が大事なら表を先に指定する。
次の内容を表で返してください。
列は「項目」「説明」「優先度」の3つにしてください。
Markdown の段落は使わず、表だけで出力してください。
対象: 共有フォルダの整理方針
この「表だけ」「Markdown の見出しと箇条書きで」といった一言が効く。
曖昧に「見やすくして」とだけ頼むと、文章がだらだら続いたり、見出しが多すぎたり、途中で表に逃げたりする。人間から見ると整っていない。Claude Code は指示の余白を埋めるのがうまいぶん、形式指定がないと勝手に寄せてくるのだ。
筆者は以前、ファイル整理の説明を頼むときに「わかりやすくまとめて」とだけ書いて失敗した。返ってきたのは、段落中心の説明だった。内容は悪くない。でも、そのまま社内共有の資料に貼るには長い。あとから表に直す作業が発生して、最初から表で頼めばよかったと痛感した。こういう無駄は、地味だが積み重なる。
形式を決めるときは、欲しい見た目だけでなく、使い道まで一緒に書くとさらに安定する。たとえば、文書作成なら「そのまま貼れる短い Markdown」、ファイル棚卸しなら「列幅をそろえた表」、比較検討なら「行ごとに差が見える表」だ。Claude Code はこの手の目的を拾うのが上手い。
次のメモを、社内チャットにそのまま貼れる短い Markdown で整えてください。
箇条書きは3段までにしてください。
長い説明は削ってください。
次の一覧を、Excel に貼りやすい表形式で返してください。
各行は1件、列は「ファイル名」「種類」「残すか削除か」「理由」です。
ここで気をつけたいのは、形式指定を増やしすぎて中身を縛りすぎないことだ。
「必ず4行」「各項目は12文字以内」「1セル1文」みたいに細かくしすぎると、肝心の情報が削られる。形式は先に固定する。だが、内容までガチガチに縛る必要はない。まずは「Markdown か表か」を決めるだけで十分な場面が多い。
もう一つ、地味に大事なのは「混ぜない」ことだ。
Markdown と表を同時に要求すると、どちらつかずになることがある。特に、段落の説明のあとに表を置け、と曖昧に頼むと、読み手には親切でも編集には不親切な出力になりやすい。文章なら文章、一覧なら表。最初に主役を一つ決めるのがいい。
次の内容は、まず結論を短い箇条書きで出し、そのあとに詳細説明をMarkdownで続けてください。
表は使わないでください。
こういうふうに順番まで指定すると、出力のブレが減る。
「先に結論、あとに理由」という型は、レビューや下書きではかなり使える。読む側も迷いにくい。
非エンジニアの用途でも、この考え方はそのまま効く。たとえば、散らかった写真フォルダの整理方針を作らせるなら、まず Markdown で方針の説明を書かせるのか、表で「残す・移す・削除候補」を出させるのかを決める。契約書や申請書のメモなら、段落で読ませるより、表にしたほうが確認が速いことも多い。逆に、手順書は Markdown のほうが読みやすい。形式の選び方で、作業のしやすさがかなり変わる。
一歩進めるなら、出力形式を固定したあとに「その形式のまま終わる」まで言い切るといい。余計な前置きや言い訳を減らせる。
次の内容をMarkdownで整理してください。
冒頭の前置きは不要です。
見出しは3つまでにしてください。
最後に要約は付けないでください。
次の一覧を表で返してください。
表以外の文章は不要です。
この手の指定を入れるだけで、返答の再利用性がかなり上がる。
Claude Code は中身を作る力が強いぶん、出力の形をこちらが先に決めないと、あとで整える仕事が残る。実務では、そこがいちばん面倒だ。
迷ったら、次の順で考えるといい。まず、読むのか、貼るのか、比較するのかを決める。読むなら Markdown、比較するなら表、社内共有で流すだけなら短い箇条書き。これだけで十分なことが多い。
そして依頼文の冒頭に、形式を一文で固定する。これが、後から直す回数を減らす一番手っ取り早い方法だ。