KDIGI CMS

Tính năng

Trình soạn thảo Markdown (Milkdown) trong KDIGI CMS

Viết trong giao diện trực quan, lưu Markdown thuần, và nhận HTML đã làm sạch qua REST.

Cập nhật lần cuối:

Tài liệu kính mờ với thanh tiêu đề xanh, bảng và ảnh nhỏ, cạnh một cây bút đất sét, đại diện cho trình soạn thảo Markdown

KDIGI CMS soạn bài bằng Milkdown (lõi Crepe). Nguồn sự thật là Markdown (contentMd, CommonMark + GFM); REST trả HTML đã làm sạch ở khóa content.

Tóm tắt nhanh

  • Nguồn sự thật là Markdown, không phải HTML.
  • Slash menu /: tiêu đề, bảng, ảnh, shortcode.
  • @ chèn liên kết nội bộ cùng site.
  • Dán từ Docs hoặc Word thành GFM.
  • HTML đầu ra qua sanitize-html.

Trình soạn thảo Markdown trong trang chỉnh sửa bài viết

Điểm nổi bật

  • Slash menu Gõ / để chọn tiêu đề 1–6, danh sách, bảng, ảnh, khối mã.
  • Liên kết nội bộ Gõ @ để tìm bài, trang, sản phẩm, landing cùng site.
  • Dán từ Docs/Word HTML chuyển sang GFM, ảnh nhúng tự tải lên.
  • Ảnh Dán, kéo thả hoặc nhập từ URL vào thư viện media.
  • Shortcode [sc name="ten" /] dùng lại đoạn Markdown theo site.
  • Tìm và thay thế Ctrl/Cmd+F; bảng phím tắt ở Ctrl/Cmd+/.

Slash menu mở trong trình soạn thảo

Mẹo Liên kết nội bộ là yếu tố SEO: bộ chấm điểm kiểm tra tối thiểu một liên kết nội bộ. Xem SEO và JSON-LD.

API trả gì cho frontend

Kênh đọc content trả về
REST HTML đã render và làm sạch
GraphQL JSON Lexical thô, không mở rộng shortcode
Local API JSON Lexical thô

Cần HTML ngoài REST thì đọc contentMd rồi tự render. Xem Headless API.

Đầu ra an toàn

  • Loại <script>, <style>, <iframe>
  • Loại thuộc tính style và trình xử lý sự kiện
  • Thêm width/height cho ảnh, giảm dịch chuyển bố cục
  • Shortcode chỉ mở rộng trong cùng site

Lưu ý Gallery hai cột của WordPress được giữ nguyên khi chuyển, hiển thị như khối chỉ đọc. Xem chuyển từ WordPress.

Quy trình viết bài

  1. Dựng khung Gõ / để chọn H2, H3.
  2. Dán bản nháp Từ Google Docs; kiểm tra lại bảng và ảnh.
  3. Chèn liên kết Dùng @ tới vài bài liên quan.
  4. Đặt SEO Từ khóa chính ở tab SEO.
  5. Lưu và đăng Qua quy trình biên tập.

Chi tiết kỹ thuật: Soạn thảo Markdown. Quay lại tổng hợp tính năng.

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

Có dán được nội dung từ Google Docs hoặc Word không?

Có. HTML trong clipboard được chuyển sang GFM, ảnh nhúng dạng data được tải lên thư viện media, và cả lần dán là một bước hoàn tác. Văn bản thuần và Markdown được dán nguyên bản.

API trả về Markdown hay HTML?

Qua REST, trường content là HTML đã làm sạch, còn Markdown gốc ở contentMd. GraphQL và Local API trả giá trị lưu thô, nên frontend nên đọc qua REST.

Shortcode dùng để làm gì?

Là đoạn Markdown dùng lại (bảng giá, chính sách), lưu theo từng site và chèn bằng [sc name="ten" /]. CMS mở rộng khi render qua REST, lồng tối đa 3 cấp.

HTML thô trong Markdown có an toàn không?

Có. Đầu ra qua markdown-it rồi sanitize-html với danh sách cho phép; script, style, iframe, thuộc tính style và trình xử lý sự kiện đều bị loại.
Đọc tài liệu kỹ thuật tương ứng

Đọc tiếp