Vẽ sơ đồ bằng văn bản với Mermaid — Tạo lưu đồ và sơ đồ kiến trúc chỉ bằng text thuần

Đã được xem xét và xác minh bởi FeiYueh · Lần xác minh gần nhất 2026-09-28

Mermaid biến lưu đồ thành văn bản thuần có thể quản lý phiên bản: một khối mã 10 dòng là đủ để tạo ra một lưu đồ hoàn chỉnh, muốn sửa hình chỉ cần sửa chữ, khôn

Mermaid biến lưu đồ thành văn bản thuần có thể quản lý phiên bản: một khối mã 10 dòng là đủ để tạo ra một lưu đồ hoàn chỉnh, muốn sửa hình chỉ cần sửa chữ, không phải vẽ lại. GitHub, GitLab, Notion, Obsidian đều đã tích hợp sẵn khả năng render gốc, nghĩa là sơ đồ bạn viết trong README hay ghi chú sẽ tự động hiển thị mà không cần bất kỳ tiện ích mở rộng nào. Vì sao vẽ bằng văn bản phù hợp với tài liệu hơn công cụ kéo thả Sơ đồ và tài liệu không đồng bộ với nhau là nguồn gốc phổ biến nhất khiến tài liệu kỹ thuật mục ruỗng. Sơ đồ kiến trúc vẽ bằng Figma hay draw.io rồi lưu thành PNG: mã nguồn đổi mà hình không đổi, nửa năm sau hình còn gây hiểu lầm hơn cả chú thích. Mermaid đặt định nghĩa của sơ đồ ngay trong cùng một tệp Markdown, thay đổi hiện ra trong diff, lọt được vào code review, nhờ vậy sơ đồ tiến hóa cùng mã nguồn. Quy mô áp dụng đã đủ lớn để trở thành chuẩn thực tế. 「GitHub đã tích hợp sẵn hỗ trợ render Mermaid trong mọi tệp Markdown từ tháng 2 năm 2022」(Nguồn: GitHub Blog) , bước đi này lập tức trao khả năng vẽ sơ đồ cho README của hàng chục triệu repository. 「Gói mermaid có hơn 2 triệu lượt tải mỗi tuần trên npm」(Nguồn: trang gói chính thức của npm) , cho thấy nó đã thâm nhập sâu vào chuỗi công cụ frontend và tài liệu. 「Dự án mermaid-js/mermaid đã tích lũy hơn 78.000 sao trên GitHub」(Nguồn: repository chính thức trên GitHub) , thuộc nhóm dẫn đầu trong các dự án mã nguồn mở về tài liệu. Khác biệt trong thực tế có thể định lượng: để vẽ một lưu đồ gồm 8 nút và 3 nhánh, công cụ kéo thả bằng chuột thường tốn 10 đến 15 phút chỉ để căn chỉnh nút và nắn hướng đường nối; với Mermaid, viết 12 dòng văn bản mất khoảng 2 phút, và bố cục do engine tự tính toán, không gặp cảnh «đường cắt nhau xấu xí» phải kéo tay từng cái. Bốn loại sơ đồ dùng nhiều nhất và cú pháp tối thiểu Lưu đồ: flowchart flowchart là loại sơ đồ được dùng nhiều nhất, phần lõi cú pháp chỉ gồm hai thứ: «nút» và «mũi tên». Hướng khai báo bằng TD (từ trên xuống) hoặc LR (từ trái sang phải): flowchart TD A[N

Đã được xem xét và xác minh bởi FeiYueh · Lần xác minh gần nhất 2026-09-28. Independently maintained — not AI-generated boilerplate.