blog.dopana

戻る

AIアシスタントや大規模言語モデル(LLM)が日常的に使われる現代において、Web上の技術記事の読まれ方は大きく変化しました。読者はただ目で読むだけでなく、ChatGPT、Claude、Cursorなどのチャット画面に記事を貼り付けて、要約や解説、質問を求めることが当たり前になっています。

しかし、ブラウザ上で通常のテキスト選択とコピー(ドラッグして Ctrl + C)を行うと、不要なHTMLタグの混入、見出し構造の崩れ、テーブルの破損、コードブロックの書式消失など、不快な結果になりがちです。

本記事では、Astroで再利用可能な「Copy as Markdown」ボタンを作成し、ブログをAIエージェントに優しい(Agent-Friendly Web)サイトへ進化させる方法を詳しく解説します。

課題:なぜWebページのコピーはAIエージェントと相性が悪いのか?#

一般的なWebページでテキストを選択してコピーすると、次のような問題が発生します:

  • クリップボードには、元のセマンティックな構造から切り離されたリッチテキストまたはプレーンテキストが渡されます。
  • Markdownリンク、脚注、シンタックスハイライト付きのコードブロック、表組みが断片化してしまいます。
  • ページ全体をまとめてコピーすると、ナビゲーションバー、フッター、ボタンのテキスト、広告などの余計なUI要素がAIのコンテキストウィンドウに混入し、トークンを無駄に消費して回答の精度を下げてしまいます。

[!NOTE] ELI5(10歳でもわかる例え話): あなたの記事を美味しいデコレーションケーキだと想像してみてください。WebページのUI(HTMLやCSS)は、ケーキを入れた紙箱やプラスチックのフォーク、飾りリボンにあたります。AIの友達がケーキを食べたいとき、欲しいのは純粋なスポンジケーキ(生のMarkdown)だけです。紙箱やプラスチックのフォーク(HTMLタグやサイドバー、広告)まで一緒に飲み込みたいわけではありません!

解決策:非表示のTextareaに生のMarkdownを埋め込む#

生のMarkdownをブラウザに提供する方法には主に2つあります:

  1. HTMLデータ属性への埋め込み(例: data-markdown="..."):DOMツリーが肥大化し、特殊文字(二重引用符や改行コード、バッククォート)のエスケープ漏れで構文エラーが発生しやすく、ブラウザの描画パフォーマンスを損ないます。
  2. 非表示の<textarea>要素への埋め込み:これが最も堅牢で推奨されるアプローチです。<textarea>は改行や特殊文字を完全に保護でき、ボタンが押された際にJavaScriptから瞬時に読み出すことができます。
ブラウザ (Browser Runtime)Astro ビルド時post.bodyPropとして渡す1. クリックイベント2. クリーンな内容を取得3. チャット欄へ貼り付けソースファイル (.md / .mdx)Astro Content LayerBlogPost.astro非表示Textarea (sr-only)生のMarkdownペイロードCopy as Markdown ボタン(daisyUI)システムクリップボードAIエージェント / LLMプロンプト

実装ステップ#

ステップ1: CopyMarkdownButton.astro コンポーネントの作成#

src/components/CopyMarkdownButton.astro に独立したコンポーネントを作成します。生のMarkdown文字列(content)を受け取り、LLMの理解を助けるために任意のタイトル(title)と概要(description)を前置します。

ボタンスタイルには daisyUI 5 のユーティリティ(btn btn-sm btn-soft)を採用し、コピー完了時には成功ステート(btn-success)へ切り替わる心地よいインタラクションを持たせます:

[!TIP] View Transitions(画面遷移)対応の要点: Astroはクライアントサイドのページ遷移に対応しています。astro:page-load と astro:after-swap の両方を監視し、dataset.listener フラグで重複登録を防ぐことで、画面遷移後もイベントが正常に動作し続けます。

ステップ2: 記事レイアウト(BlogPost.astro)への組み込み#

Astro Content Collections では、blog コレクションの各 entry に未コンパイルの生のMarkdownテキストである body プロパティが含まれています。

レイアウトコンポーネントで body を取り出し、記事本文の直前にボタンを配置します:

実装によるメリット#

  1. 優れたAI連携体験: 読者が記事をCursorやClaude Projects、ChatGPTに取り込みたい時、ワンクリックで表・数式・コードブロックを崩さず完全にコピーできます。
  2. ゼロ・オーバーヘッド: サーバーAPIやランタイムでのHTML→Markdown変換ライブラリは一切不要。静的ビルド時にすべて生成されます。
  3. daisyUIによる洗練されたデザイン: ライト/ダークモードに自然に溶け込み、軽量かつアクセシブルなUIを提供します。

参考文献#