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:
- 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. - 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.
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:
---
import { cn } from '@/astro-pure/utils';
interface Props {
content?: string;
title?: string;
description?: string;
class?: string;
}
const { content = '', title, description, class: className } = Astro.props;
// Tạo ID ngẫu nhiên để liên kết chính xác nút với textarea
const textareaId = `markdown-payload-${Math.random().toString(36).slice(2, 11)}`;
// Đảm bảo payload có tiêu đề và mô tả rõ ràng cho LLM
const formattedPayload = [
title && !content.trim().startsWith('# ') ? `# ${title}\n` : '',
description ? `> ${description}\n` : '',
content,
]
.filter(Boolean)
.join('\n')
.trim();
---
<div class="copy-markdown-container inline-flex">
{/* Textarea ẩn bảo vệ toàn vẹn ký tự Markdown */}
<textarea id={textareaId} class="sr-only" aria-hidden="true" tabindex="-1" readonly>{formattedPayload}</textarea>
<button
type="button"
data-target={textareaId}
class={cn(
'copy-markdown-btn btn btn-sm btn-soft rounded-lg gap-1.5 text-xs font-normal border border-border/60 hover:border-primary/50 transition-all cursor-pointer',
className,
)}
aria-label="Copy bài viết dưới dạng Markdown"
title="Sao chép Markdown cho AI hoặc ghi chú"
>
<svg
xmlns="http://www.w3.org/2000/svg"
width="14"
height="14"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="2"
stroke-linecap="round"
stroke-linejoin="round"
class="copy-icon size-3.5 transition-transform"
aria-hidden="true"
>
<rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect>
<path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path>
</svg>
<svg
xmlns="http://www.w3.org/2000/svg"
width="14"
height="14"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="2.5"
stroke-linecap="round"
stroke-linejoin="round"
class="check-icon hidden size-3.5 text-success"
aria-hidden="true"
>
<polyline points="20 6 9 17 4 12"></polyline>
</svg>
<span class="btn-text">Copy as Markdown</span>
</button>
</div>
<script>
function setupCopyMarkdownButtons() {
const buttons = document.querySelectorAll<HTMLButtonElement>('.copy-markdown-btn');
buttons.forEach((button) => {
if (button.dataset.listener === 'true') return;
button.dataset.listener = 'true';
button.addEventListener('click', async () => {
const targetId = button.getAttribute('data-target');
if (!targetId) return;
const textarea = document.getElementById(targetId) as HTMLTextAreaElement | null;
const btnText = button.querySelector<HTMLElement>('.btn-text');
const copyIcon = button.querySelector<SVGElement>('.copy-icon');
const checkIcon = button.querySelector<SVGElement>('.check-icon');
if (!textarea || !btnText) return;
try {
// Sử dụng Clipboard API hiện đại
await navigator.clipboard.writeText(textarea.value);
// Phản hồi trực quan qua class daisyUI
const originalText = btnText.textContent;
btnText.textContent = 'Copied!';
button.classList.add('btn-success', 'text-success-content');
button.classList.remove('btn-soft');
copyIcon?.classList.add('hidden');
checkIcon?.classList.remove('hidden');
// Kích hoạt toast thông báo nếu có
document.dispatchEvent(
new CustomEvent('toast', {
detail: { message: 'Copied Markdown to clipboard!' },
}),
);
setTimeout(() => {
btnText.textContent = originalText;
button.classList.remove('btn-success', 'text-success-content');
button.classList.add('btn-soft');
copyIcon?.classList.remove('hidden');
checkIcon?.classList.add('hidden');
}, 2000);
} catch (err) {
console.error('Không thể sao chép Markdown: ', err);
}
});
});
}
// Chạy khi tải trang ban đầu và khi chuyển trang qua Astro Transitions
setupCopyMarkdownButtons();
document.addEventListener('astro:page-load', setupCopyMarkdownButtons);
document.addEventListener('astro:after-swap', setupCopyMarkdownButtons);
</script>astro[!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-loadvàastro:after-swapcùng với cờ kiểm tradataset.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:
---
// [!code focus]
import CopyMarkdownButton from '@/components/CopyMarkdownButton.astro';
import { Hero } from '@/astro-pure/components/pages';
const {
// [!code focus]
post: { id, data, body },
headings,
} = Astro.props;
const { title, description } = data;
---
<PageLayout ...>
<Hero {data} slot="header" />
{/* Nút hành động đặt ngay phía trên nội dung bài viết */}
<div class="not-prose -mt-2 mb-6 flex items-center justify-end">
<CopyMarkdownButton content={body} {title} {description} />
</div>
<slot />
</PageLayout>astroKết quả đạt được#
- 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%.
- 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.
- 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.