Viết tài liệu Markdown & Mermaid
Chuẩn hóa mọi báo cáo, tài liệu và sơ đồ thành Markdown kèm sơ đồ Mermaid dạng văn bản.
Tài liệu · Văn phòngNhập môn★ 33,030⑂ 3,248Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Kỹ năng này làm gì
Kỹ năng thiết lập Markdown + Mermaid làm định dạng mặc định cho mọi tài liệu do Claude tạo ra.
- Dùng sơ đồ dạng text thay vì ảnh: dễ so sánh trong git, hiển thị ngay trên GitHub, GitLab, Notion, VS Code.
- Có hướng dẫn cho 24 loại sơ đồ (flowchart, sequence, ER, state, gantt, mindmap, radar, sankey...) để chọn đúng loại thay vì mặc định flowchart.
- Cung cấp 9 mẫu tài liệu: pull request, issue, kanban, ADR, thuyết trình, bài nghiên cứu, tài liệu dự án, hướng dẫn, báo cáo trạng thái.
- Áp dụng quy tắc trình bày: một H1 duy nhất, emoji chỉ ở H2, trích dẫn footnote
[^N], ưu tiên bảng, bắt buộcaccTitle/accDescrcho khả năng tiếp cận. - Cấm
%%{init}và style inline để sơ đồ không vỡ ở chế độ dark mode.
Phù hợp với ai
- Nhà nghiên cứu, học viên cao học thường viết báo cáo và bài phân tích
- Lập trình viên quản lý README, tài liệu kiến trúc, ADR bằng git
- Người mệt mỏi vì phải vẽ lại ảnh sơ đồ mỗi lần chỉnh sửa
- Technical writer muốn đồng bộ phong cách tài liệu cho cả nhóm
Ví dụ sử dụng
- "Viết tài liệu cho quy trình thí nghiệm" → tạo file
.mdtheo mẫu research paper kèm flowchart và sequence diagram. - "Ghi lại quyết định kiến trúc hôm nay" → ADR theo mẫu
decision_recordkèm sơ đồ C4 hoặc block. - "Tóm tắt các bài báo đã đọc" → mindmap bản đồ khái niệm và timeline theo năm xuất bản.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/markdown-mermaid-writing từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/markdown-mermaid-writing/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas && mkdir -p ~/.claude/skills && cp -r /tmp/sas/skills/markdown-mermaid-writing ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Tải kho mã về thư mục tạm:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas - Tạo thư mục kỹ năng nếu chưa có:
mkdir -p ~/.claude/skills - Sao chép toàn bộ thư mục kỹ năng (phải kèm
references/,templates/,assets/):cp -r /tmp/sas/skills/markdown-mermaid-writing ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/markdown-mermaid-writing - Khởi động lại Claude Code, rồi thử yêu cầu: "Hãy viết tài liệu này bằng Markdown kèm sơ đồ Mermaid".
- (Tùy chọn) Xóa thư mục tạm
/tmp/sas.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT