アドバンスド・ソリューション株式会社

技術ブログ(technical-blog)

【実践編】AIに対するMarkdown記号の解釈と活用ガイド 〜人間とAI、それぞれの視点から〜

執筆者のアイコン

アドバンスド・ソリューション(ADS)

目次

はじめに

先端技術センターのR.Iです。 AIの研究や新しいサービスの利用を日常的に行っています。
前回は「AIの記憶をリセット・継承と再教育」についてお話ししましたが、今回はより実践的なスキルとして、「プロンプトエンジニアリングにおけるMarkdownの活用」について深掘りしていきたいと思います。
「プロンプトエンジニアリング」というと難しそうに聞こえるかもしれませんが、要は「AIに伝わりやすい指示の出し方」のことです。

今回は、エンジニアには馴染み深く、非エンジニアの方でもチャットツールやドキュメント作成で目にする機会が増えた「Markdown(マークダウン)」記号に焦点を当て、人間とAIそれぞれの視点からその活用法を解説します。

1.バージョン履歴の保存設定とテナント全体のストレージ容量

AIの話に入る前に、まずは人間にとってMarkdownがどのようなものかをおさらいしましょう。Markdownとは、簡単な記号を使って、文章の見栄えや構造を整えるための記述ルールです。
ここでは、特によく使われる基本の3つと、少し特殊な「コードブロック」について、「どう書くか(入力)」と「どう見えるか(表示)」のサンプルを紹介します。

① 見出し (#)

行の先頭に # と半角スペースを入れることで、文字を大きくし、見出しとして扱います。# の数で階層(大きさ)を調整できます。

記述例(入力)

Markdown

# 一番大きな見出し

## 二番目の見出し

### 三番目の見出し

実際の見た目

一番大きな見出し

二番目の見出し

三番目の見出し

② 箇条書き (-)

行の先頭に – (ハイフン)と半角スペースを入れると、リストになります。

記述例(入力)

Markdown

– リストA

– リストB

  – インデント(字下げ)も可能です

実際の見た目

  • リストA
  • リストB
    • インデント(字下げ)も可能です

③ 太字 (**)

強調したい言葉を ** (アスタリスク2つ)で挟みます。

記述例(入力)

Markdown

ここは普通ですが、**ここだけ重要です。**

実際の見た目

ここは普通ですが、ここだけ重要です。

④ コードブロック (“```)

ここが少し特殊ですが、非常に重要です。「バッククォート(`)」を3つ並べた行で、文章やデータを上下から挟み込みます。こうすると、その中は「独立した枠(ブロック)」として表示されます。 ※バッククォート(`)は、キーボードの「Shift + @」キーなどで入力できます(JIS配列の場合)。

記述例(入力)

<pre>
`ここに書いた文章は
グレーの枠で囲まれます。
プログラムのコードや、長いデータを貼る時に使います。`
</pre>

実際の見た目

ここに書いた文章は
グレーの枠で囲まれます。
プログラムのコードや、長いデータを貼る時に使います。


2.AIはMarkdownを「情報の地図」として読んでいる

人間にとっては「見やすくするための装飾」でしたが、AI(LLM)はこの記号をどう読んでいるのでしょうか? 実はAIにとって、Markdownは単なる装飾ではなく、文章の構造や重要度を理解するための「情報の地図(構造化された指示)」として機能しています。

AIはテキストを平坦に読むのではなく、記号を手がかりに文書の論理構造を解析しています。

各記号のAIによる具体的解釈

  1. 見出し (#, ##):文脈のスコープ定義 AIはこれらを「ここから新しい話題が始まる」「これは親トピックに属する詳細である」という文脈の区切りとして認識します。適切に見出しをつけることで、AIは情報のスコープ(範囲)を特定できるため、長文の指示を与えても文脈を見失いにくくなります。
  2. 太字 (強調):重要度の重み付け 太字はAIに対して「この単語や指示は、周囲のテキストよりも重要度が高い」と伝えるサインになります。AIの注意機構(Attention Mechanism)に働きかけ、処理時の優先順位を上げる効果があります。「絶対に」や「禁止」といった強い言葉と組み合わせるとより効果的です。
  3. リスト (-, 1.):タスクの分離 箇条書きは「独立した情報の羅列」、番号付きリストは「順序のある手順」として認識されます。文章でダラダラと書くよりも、AIが各要素を「個別のタスク」として認識しやすくなるため、処理の抜け漏れを防ぐことができます。
  4. コードブロック (“`):情報の隔離 プロンプト作成において最も重要なのがこの記号です。AIは「ここからここまで囲われた部分は、指示文ではなく『参照用データ』や『コード』である」と明確に区別します。「以下の文章を要約して」と指示しつつ、対象の文章をコードブロックで囲む(カプセル化する)ことで、指示とデータが混ざることを防げます。
  5. 絵文字 (🚫, 📋, 👤 など):意味のアンカー プロンプトでよく使われる絵文字も、AIにとっては重要な情報源です。AIは絵文字が持つ意味(例:🚫=禁止、🛑=止まれ、👤=役割)を理解しています。見出しとセットで使うことで、そのセクションの役割を視覚的かつ意味的に強調し、AIに「ここは制約条件である」と強く認識させるアンカー(錨)の役割を果たします。

3.AIによる遵守精度と精度の高め方

「Markdownで書けば完璧に伝わるのか?」という点については、「基本的に構造を理解し遵守しようとするが、100%の保証はない」というのが現実です。 AIは、見出しによる区切りや、コードブロック内のデータの保持については高い精度で理解します。一方で、文脈に依存する曖昧な装飾や、独自に定義した複雑な記号ルールなどは誤解されるリスクがあります。

精度を高めるためのテクニック

重要な指示を確実に通すためには、記号に加えて以下のような工夫が有効です。

  • 物理的な区切りを入れる: 水平線 (—) を用いてセクションを視覚的・論理的に明確に分けることで、AIが話題の転換を認識しやすくなります。
  • 構造と強い言葉を組み合わせる: 単に太字にするだけでなく、## 🚫 絶対禁止事項 のように、「見出し」+「アイコン」+「強い言葉」をセットにすることで、AIに対して強く注意を喚起できます。

4.すぐに使える推奨プロンプトテンプレート

以上の特性を踏まえ、AIに誤解なく指示を伝えるためのテンプレートを作成しました。Markdownの構造化特性をフル活用していますので、業務での要件定義やドキュメント作成時にぜひご活用ください。

Markdown

# 📋 依頼の概要

ここに、AIに依頼したいタスクの目的や背景を簡潔に記述します。

(例:以下の入力データを元に、Webサイト用の要件定義書を作成してください。)

## 👤 あなたの役割

* **ロール:** シニアWebエンジニア

* **トーン:** 専門的かつ論理的

* **対象読者:** プロジェクトマネージャーおよびクライアント

## 🚫 制約条件・禁止事項(重要)

以下のルールは**絶対に遵守**してください。

1. **捏造の禁止:** 入力データにない情報は記載しないこと。

2. **言語:** 出力はすべて「日本語」で行うこと。

3. **フォーマット:** 指定した出力形式以外は出力しないこと(挨拶文などは不要)。

## 📥 入力データ

以下のデータを処理の対象としてください。

“`text

(ここに解析させたいテキスト、コード、会議の議事録などを貼り付けます)

(※コードブロックで囲むことで、AIはこれを「指示」ではなく「読むべきデータ」として扱います)


📤 期待する出力形式

以下のフォーマットに従って出力してください。

[成果物タイトル]

1. 要約

(ここに要約を記述)

2. 課題点一覧

  • (課題1)
  • (課題2)

3. 推奨アクション

優先度:高

  • アクション内容…

優先度:中

  • アクション内容…


まとめ

Markdownは、人間にとっては「読みやすくするためのツール」ですが、AIにとっては「理解を助けるための共通言語」でもあります。

日々の業務で「AIがいまいち意図を汲んでくれない」と感じたときは、プロンプトの言葉選びだけでなく、「Markdownによる構造化」を意識してみてはいかがでしょうか。

ほんの少し記号を加えるだけで、AIの回答精度がぐっと上がるかもしれません。

執筆者のアイコン

アドバンスド・ソリューション(ADS)

この記事を書いた人

ADSブログ運営事務局です。SharePoint・Microsoft 365を中心としたDX推進や業務効率化の現場経験をもとに、実践的なノウハウや最新情報をお届けします。

無料相談・オンラインミーティング
からはじめませんか?

貴社の課題に合わせた解決プランを無料でご提案します。​
どうぞお気軽にご連絡ください。