blog.dopana

Quay lại

Trong kỷ nguyên của các trợ lý AI và mô hình ngôn ngữ lớn (LLM), hành vi đọc web đã thay đổi hoàn toàn. Người dùng không chỉ đọc bằng mắt mà còn thường xuyên sao chép bài viết đưa vào ChatGPT, Claude hay Cursor để tóm tắt, giải thích và đặt câu hỏi.

Tuy nhiên, thao tác sao chép truyền thống (bôi đen văn bản rồi Ctrl + C) thường mang lại kết quả rất tệ: lẫn lộn thẻ HTML rác, mất cấu trúc tiêu đề, vỡ bảng biểu và làm hỏng định dạng code block.

Bài viết này hướng dẫn bạn cách xây dựng một nút “Copy as Markdown” tái sử dụng cho Astro, giúp biến blog của bạn thành một website thân thiện với AI Agent (Agent-Friendly Web).

Vấn đề: Tại sao sao chép từ Web lại khó khăn với AI?#

Khi bạn bôi đen và sao chép nội dung trên một trang web thông thường:

  • Bộ nhớ tạm (Clipboard) nhận một chuỗi văn bản thuần (rich text hoặc plain text) đã bị bóc tách khỏi cấu trúc gốc.
  • Các liên kết nội bộ, chú thích footnote, khối code và bảng biểu Markdown biến thành các đoạn văn bản rời rạc.
  • Nếu người dùng copy toàn bộ trang, các thành phần giao diện như thanh điều hướng (navbar), chân trang (footer), nút bấm và quảng cáo sẽ lọt vào ngữ cảnh (context window) của AI, gây lãng phí token và làm giảm độ chính xác của câu trả lời.

[!NOTE] ELI5 (Giải thích như trẻ lên 10): Hãy tưởng tượng bài viết của bạn là một chiếc bánh kem thơm ngon. Giao diện trang web (HTML/CSS) là đĩa, nĩa và hộp đựng trang trí xung quanh. Khi một người bạn AI muốn thưởng thức bánh, họ chỉ cần phần cốt bánh (Markdown gốc), chứ không hề muốn nhai cả đĩa nhựa và nơ trang trí (thẻ HTML, sidebar, banner)!

Giải pháp: Inject Markdown vào Textarea ẩn#

Có hai cách tiếp cận phổ biến để cung cấp Markdown gốc:

  1. Gắn vào thuộc tính HTML (ví dụ: data-markdown="..."): Cách này khiến cây DOM bị phình to (bloated DOM), dễ bị lỗi escape ký tự đặc biệt (dấu ngoặc kép, ký tự xuống dòng) và làm chậm quá trình render của trình duyệt.
  2. Inject vào thẻ <textarea> ẩn: Đây là kỹ thuật tối ưu nhất. Thẻ <textarea> cho phép lưu giữ trọn vẹn văn bản nhiều dòng, không bị ảnh hưởng bởi cú pháp HTML, và có thể truy xuất tức thì qua JavaScript khi người dùng nhấn nút.
Trình duyệt (Browser)Astro Build Timepost.bodyTruyền prop1. Bắt sự kiện Click2. Đọc payload sạch3. Dán vào chatboxTệp nguồn (.md / .mdx)Astro Content LayerBlogPost.astroTextarea ẩn (sr-only)Chứa Markdown nguyên bảnNút Copy as Markdown(daisyUI)Clipboard hệ thốngAI Agent / LLM Prompt

Các bước triển khai#

Bước 1: Tạo Component CopyMarkdownButton.astro#

Chúng ta tạo một component độc lập tại src/components/CopyMarkdownButton.astro. Component này nhận nội dung Markdown thô (content), cùng tiêu đề và mô tả tùy chọn để làm giàu ngữ cảnh cho AI.

Giao diện nút bấm được thiết kế hiện đại với thư viện daisyUI 5 (btn btn-sm btn-soft), hỗ trợ phản hồi trực quan (visual feedback) chuyển đổi sang trạng thái thành công (btn-success) khi sao chép xong:

[!TIP] Điểm mấu chốt cho Single Page App (SPA): Astro hỗ trợ View Transitions. Việc lắng nghe cả hai sự kiện astro:page-load và astro:after-swap cùng với cờ kiểm tra dataset.listener đảm bảo nút bấm luôn hoạt động hoàn hảo khi người dùng điều hướng giữa các bài viết mà không bị trùng lặp listener.

Bước 2: Tích hợp vào Layout Bài Viết (BlogPost.astro)#

Trong cấu trúc của Astro Content Collections, mỗi entry từ bộ sưu tập blog đều chứa thuộc tính body biểu diễn toàn bộ nội dung Markdown chưa qua biên dịch.

Chúng ta chỉ cần bóc tách body và đặt nút ngay phía trên nội dung chính của bài viết:

Kết quả đạt được#

  1. Trải nghiệm AI tuyệt vời: Khi người đọc muốn mang bài viết của bạn vào Cursor, Claude Projects hoặc ChatGPT, họ chỉ cần 1 cú click. Toàn bộ định dạng bảng, danh sách, công thức và code block được giữ nguyên vẹn 100%.
  2. Không tốn tài nguyên: Không cần API server, không cần xử lý chuyển đổi HTML sang Markdown ở runtime; toàn bộ payload được tạo sẵn tại build-time tĩnh của Astro.
  3. Thẩm mỹ tinh tế: Nút bấm daisyUI nhỏ gọn, ăn khớp hoàn hảo với hệ thống màu giao diện (Light/Dark mode) của blog.

Tài liệu tham khảo#