Tóm tắt nhanh:
ak-mermaidjs-v11viết sơ đồ cho tài liệu bằng cú pháp Mermaid v11, là chữ nên sửa và review như code. Mặc định nó chỉ đưa ra khốimermaidđể dán vào Markdown, không cài thêm gì. Nó chỉ xuất SVG, PNG hay PDF khi bạn cần file ảnh, và luôn mở file ra xem lại.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi tài liệu cần một sơ đồ: luồng xử lý, trình tự gọi API, schema database, lịch dự án. Không cần khi bạn muốn một sơ đồ chất lượng xuất bản thay vì sơ đồ Mermaid, việc đó là của ak-tech-graph.
flowchart LR
A["Mô tả sơ đồ cần vẽ"] --> B["ak-mermaidjs-v11"]
B --> C["Khối mermaid trong Markdown"]
B --> D["File SVG, PNG, PDF"]
D --> E["Soát bố cục theo ak-tech-graph"]Nó luôn xét 4 điều:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Loại sơ đồ | Bạn đang muốn thể hiện điều gì? | Thứ tự gọi nhau dùng sequenceDiagram, quan hệ bảng dùng erDiagram, mốc thời gian dùng gantt |
| Hiển thị tại chỗ hay xuất file | Sơ đồ sẽ được xem ở đâu? | README trên GitHub chỉ cần khối mermaid; slide hay Word cần xuất ảnh bằng mmdc |
| Cấu hình ngay trong sơ đồ | Muốn đổi giao diện một sơ đồ mà không đụng cấu hình chung? | Frontmatter theme: dark, look: handDrawn hoặc layout: elk ở đầu khối |
| Nơi hiển thị hỗ trợ tới đâu | Chỗ bạn dán sơ đồ có vẽ được cú pháp này không? | Kiểm trước khi dùng architecture-beta kèm icon pack |
Mô tả càng nêu rõ các thành phần và quan hệ giữa chúng thì sơ đồ càng ít phải sửa.
Prompt mẫu cho luồng xử lý trong README:
/ak-mermaidjs-v11 flowchart cho luồng duyệt đơn hàng của <tên app>:
đơn mới -> kiểm tồn kho -> đủ hàng thì thanh toán, thiếu hàng thì báo khách.
Đặt vào README.md, mục "Luồng đơn hàng". Dùng ID node có nghĩa, ghi nhãn trên mũi tên.Skill này không có cờ. Sau tên lệnh, bạn ghi tên loại sơ đồ (như flowchart, sequenceDiagram, gantt) hoặc mô tả bằng lời thứ bạn muốn vẽ.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách ghi đầu vào, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-mermaidjs-v11: vẽ sơ đồ Mermaid v11 nhúng vào Markdown" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-mermaidjs-v11". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-mermaidjs-v11
