Xem trước Markdown
Cấu hình
Giao diện
Chọn giao diện dùng để xem trước Markdown
Tô sáng cú pháp
Tô sáng các khối mã bằng Shiki
Markdown theo phong cách GitHub
Ngắt dòng
Hỗ trợ Emoji
Chuyển đổi mã ngắn :emoji: thành emoji
Markdown
Xem trước
Chi tiết kỹ thuật
Cách Bản xem trước Markdown Hoạt động
Công cụ làm gì
Công cụ xem trước markdown chuyển đổi văn bản Markdown thành đầu ra HTML đã định dạng, cung cấp khả năng render theo thời gian thực để xem markdown của bạn sẽ hiển thị như thế nào khi được xuất bản. Trình soạn thảo và trình xem markdown này cho phép nhà phát triển và người viết xem trước markdown, kiểm thử cú pháp markdown và đảm bảo định dạng đúng trước khi xuất bản. Công cụ hoạt động như một bộ chuyển đổi và bộ render markdown, hỗ trợ GitHub-flavored markdown (GFM), bảng, khối mã và nhiều phần mở rộng markdown khác. Khi bạn cần xem trước markdown trực tuyến hoặc kiểm thử định dạng markdown, công cụ chạy trên trình duyệt này cung cấp phản hồi trực quan tức thì mà không cần trình soạn thảo markdown cục bộ hay cài đặt.
Các trường hợp sử dụng phổ biến cho lập trình viên
Các lập trình viên sử dụng công cụ xem trước markdown khi viết tệp README, tài liệu, bài blog hoặc GitHub issue cần định dạng markdown. Chức năng xem trước markdown là thiết yếu khi tạo tài liệu kỹ thuật, nơi bạn cần xác minh rằng các khối mã, bảng và liên kết được hiển thị chính xác. Nhiều lập trình viên dùng xem trước markdown khi viết GitHub-flavored markdown, đảm bảo tương thích với bộ máy hiển thị của GitHub. Công cụ này hữu ích khi chuyển đổi markdown sang HTML để xuất bản web, kiểm thử cú pháp markdown cho các trình tạo trang tĩnh như Jekyll hoặc Hugo, hoặc khi tạo nội dung markdown cho các nền tảng hỗ trợ hiển thị markdown. Nó cũng có giá trị với các nhà sáng tạo nội dung viết bằng markdown nhưng cần xem đầu ra đã được định dạng trước khi xuất bản lên blog, wiki hoặc trang tài liệu.
Định dạng dữ liệu, kiểu hoặc biến thể
Trình xem trước markdown hỗ trợ cú pháp CommonMark tiêu chuẩn và các phần mở rộng GitHub-flavored markdown. Nó xử lý định dạng cơ bản như tiêu đề, chữ đậm, chữ nghiêng, liên kết và danh sách, cũng như các tính năng nâng cao như bảng, khối mã có tô sáng cú pháp, chữ gạch ngang và danh sách công việc. Công cụ xử lý mã nội tuyến, code fence có chỉ định ngôn ngữ, trích dẫn khối, đường kẻ ngang và nhúng hình ảnh. Nó hỗ trợ nhiều phương ngữ markdown, bao gồm GitHub-flavored markdown (GFM), vốn bổ sung hỗ trợ cho bảng, danh sách công việc, gạch ngang và liên kết tự động. Một số triển khai cũng hỗ trợ biểu thức toán học, chú thích cuối trang và các phần mở rộng tùy chỉnh. Bản xem trước xử lý cả phần tử cấp khối lẫn định dạng nội tuyến, đảm bảo thể hiện chính xác đầu ra hiển thị cuối cùng.
Các lỗi thường gặp và trường hợp biên
Khi sử dụng xem trước markdown, hãy lưu ý rằng các bộ xử lý markdown khác nhau có thể hiển thị nội dung hơi khác nhau. GitHub-flavored markdown có các quy tắc riêng về xuống dòng, định dạng bảng và phát hiện liên kết tự động có thể không khớp với các triển khai markdown khác. Một số vấn đề phổ biến gồm xử lý xuống dòng không nhất quán (yêu cầu hai dấu cách hoặc hai dòng trống), định dạng bảng hoạt động ở bộ xử lý này nhưng không hoạt động ở bộ xử lý khác, và khác biệt trong cách thoát ký tự đặc biệt. Tô sáng cú pháp cho khối mã có thể khác nhau tùy theo ngôn ngữ được chỉ định và bộ tô sáng cú pháp sẵn có. HTML nhúng trong markdown có thể bị làm sạch khác nhau giữa các nền tảng, có thể làm hỏng định dạng mong muốn. Luôn kiểm thử markdown của bạn trên nền tảng đích để đảm bảo hiển thị nhất quán.
Khi nào nên dùng công cụ này thay vì viết mã
Hãy dùng trình xem trước markdown trên trình duyệt này để kiểm tra nội dung nhanh, tạo tài liệu một lần, hoặc khi làm việc trên máy không cài trình soạn thảo markdown. Nó lý tưởng để thử cú pháp markdown, xem trước nội dung trước khi xuất bản, hoặc khi bạn cần chia sẻ bản xem trước đã định dạng với các bên liên quan không chuyên kỹ thuật. Đối với việc tạo nội dung phục vụ sản xuất, hãy cân nhắc dùng các trình soạn thảo markdown chuyên dụng có xem trước trực tiếp (như Typora, Mark Text hoặc VS Code với các tiện ích mở rộng markdown) cho hiệu năng tốt hơn, quản lý tệp cục bộ và tích hợp với hệ thống quản lý phiên bản. Xử lý markdown bằng mã với các thư viện như markdown-it, remark hoặc marked cung cấp nhiều quyền kiểm soát hơn đối với tùy chọn hiển thị và có thể tích hợp vào pipeline build. Công cụ trên trình duyệt mạnh về xem nhanh và chia sẻ, trong khi trình soạn thảo chuyên dụng cung cấp tích hợp quy trình làm việc tốt hơn cho việc tạo nội dung markdown thường xuyên.