blog.dopana

返回

在人工智能助手与大语言模型(LLM)普及的今天,用户阅读网络文章的方式发生了根本转变。读者不仅用眼睛浏览,还频繁地将文章复制到 ChatGPT、Claude 或 Cursor 中,用于生成摘要、提问或者重构代码。

然而,传统的网页复制操作(划选文本并执行 Ctrl + C)体验往往非常糟糕:混杂大量无用 HTML 标签、标题层级丢失、表格错位,代码块的格式也常常荡然无存。

本文将介绍如何在 Astro 中实现一个可复用的 “Copy as Markdown” 按钮,让你的博客升级为对 AI 智能体友好的现代化站点(Agent-Friendly Web)。

问题根源:为什么直接从网页复制对 AI 不友好?#

当用户在常规网页中划选并复制内容时:

  • 剪贴板获取到的是脱离了语义原貌的富文本或纯文本。
  • Markdown 链接、脚注、带语法高亮的代码块以及排版表格会被拆解成互不连贯的碎片。
  • 如果用户全选复制整页,导航栏、页脚、交互按钮和广告等外围界面元素都会涌入 LLM 的上下文窗口(Context Window),不仅浪费 Token,还会降低模型的回答质量。

[!NOTE] ELI5(通俗比喻,讲给10岁孩子听): 想象一下,你写的文章是一块香甜可口的奶油蛋糕。网页的 UI 界面(HTML/CSS)是装蛋糕的包装盒、塑料叉子和装饰丝带。当你的 AI 小伙伴想品尝蛋糕时,它需要的仅仅是纯净的蛋糕本体(原始 Markdown),绝不想连着塑料盒与丝带(HTML 标签、侧边栏和广告)一起嚼进肚子里!

解决方案:将原始 Markdown 注入隐藏的 Textarea#

向前端提供原始 Markdown 通常有两种架构方案:

  1. 直接存入 HTML 数据属性(例如 data-markdown="..."):这种方式会导致 DOM 树急剧膨胀,容易出现特殊符号(双引号、换行符、反引号)转义错误,并显著拖慢浏览器的渲染性能。
  2. 注入视觉隐藏的 <textarea> 元素:这是行业公认的最佳实践。<textarea> 标签天然支持多行文本与各类特殊字符,完全不受 HTML 实体转义困扰,且点击复制按钮时可通过 JavaScript 毫秒级提取。
浏览器端 (Browser Runtime)Astro 构建阶段post.body传递属性1. 监听点击事件2. 提取干净文本3. 粘贴至对话框源文件 (.md / .mdx)Astro Content LayerBlogPost.astro隐藏Textarea (sr-only)存储原始Markdown载荷Copy as Markdown 按钮(daisyUI)系统剪贴板AI Agent / LLM提示词

详细实现步骤#

第一步:创建 CopyMarkdownButton.astro 组件#

我们在 src/components/CopyMarkdownButton.astro 创建独立组件。该组件接收未编译的 Markdown 字符串(content),以及可选的文章标题(title)和描述(description),从而为 LLM 补全上下文。

按钮外观采用 daisyUI 5 实用类(btn btn-sm btn-soft)进行现代化设计,复制成功后会平滑切换至成功状态(btn-success),提供良好的视觉反馈:

[!TIP] View Transitions 单页过渡兼容性: Astro 支持客户端平滑页面过渡。通过同时监听 astro:page-load 与 astro:after-swap,并使用 dataset.listener 防重标记,能确保用户在文章之间跳转后按钮依然完美响应,且避免重复绑定事件。

第二步:集成至文章布局文件(BlogPost.astro)#

在 Astro 内容集合(Content Collections)中,blog 集合的每一个 entry 都有一个名为 body 的字段,里面存放着未编译的原始 Markdown 内容。

我们在布局组件中直接解构 body,并将复制按钮放置在文章正文上方:

核心收益#

  1. 卓越的 AI 协作体验: 当读者希望把文章放入 Cursor、Claude Projects 或 ChatGPT 时,一键即可获得结构完整、代码块清晰、表格无损的 Markdown 文本。
  2. 零运行时开销: 不需要任何服务器后端接口,也不依赖客户端沉重的 HTML 转 Markdown 转换库,所有内容均在 Astro 静态构建期生成。
  3. daisyUI 精致视觉呈现: 按钮小巧雅致,自带无障碍支持,完美适配网站的浅色与深色主题模式。

参考资料#