Giao diện

Câu hỏi thường gặp ​

Upload ảnh báo lỗi "Storage not configured"? ​

Plugin cần file storage đã cấu hình qua plugin-file-manager. Kiểm tra:

  • File storage (S3, local...) đã tạo và hoạt động.
  • Server action vditor:check trả về true.
  • Nếu chưa có storage, vẫn soạn text/markdown bình thường — chỉ không upload được ảnh.

Editor không hiển thị — trang trắng hoặc lỗi? ​

Kiểm tra:

  • Assets Vditor đã được copy vào public (kiểm tra thư mục public/vditor/).
  • Nếu thiếu assets, chạy lại build hoặc restart server.
  • Kiểm tra console trình duyệt cho lỗi tải JS/CSS.

Công thức KaTeX / sơ đồ Mermaid không render? ​

Các thư viện này được lazy-loaded. Kiểm tra:

  • Kết nối mạng (nếu dùng CDN ngoài) hoặc local assets có đầy đủ.
  • Syntax đúng: $...$ cho KaTeX, code block với ngôn ngữ mermaid cho sơ đồ.
  • Thử chuyển sang chế độ preview để kiểm tra rendering.

Nội dung lưu Markdown hay HTML trong database? ​

Markdown text. Không lưu HTML. Rendering thành HTML chỉ xảy ra ở client khi hiển thị. Điều này đảm bảo dữ liệu clean và portable.

Có thể dùng plugin này cho rich text thay vì Markdown không? ​

Chế độ WYSIWYG cho trải nghiệm gần giống rich text editor — người dùng không cần biết Markdown syntax. Tuy nhiên, dữ liệu bên dưới vẫn là Markdown.

Ảnh upload bị mất sau khi di chuyển server? ​

Ảnh lưu trên file storage, không trong database. Khi di chuyển server, cần migrate cả file storage (S3 bucket hoặc thư mục local uploads). URL ảnh trong markdown vẫn giữ nguyên.

Editor có nặng không? Ảnh hưởng hiệu năng trang? ​

Vditor được lazy-loaded — bundle chỉ tải khi mở field chứa editor. Các thư viện phụ (KaTeX, Mermaid...) cũng lazy-load theo nhu cầu. Trang không chứa field markdown không bị ảnh hưởng.

Có hỗ trợ collaborative editing (nhiều người soạn cùng lúc) không? ​

Không. Plugin hiện tại hỗ trợ single-user editing. Nếu hai người cùng sửa một bản ghi, người lưu sau sẽ ghi đè nội dung.