Trình soạn thảo Markdown là môi trường viết hai khung song song: bạn gõ Markdown dạng văn bản thuần ở một bên, còn bản xem trước đã hiển thị cập nhật trực tiếp ở bên kia. Đây là định dạng đứng sau các tệp README trên GitHub, cổng tài liệu, trình tạo trang tĩnh, nền tảng blog, ứng dụng ghi chú như Obsidian và công cụ chat như Discord, Slack.
Mục đích của Markdown là dễ đọc ở dạng văn bản thuần và trở thành HTML có cấu trúc khi hiển thị. Bạn bớt thời gian loay hoay với thanh công cụ định dạng và có thêm thời gian để viết, đó chính là lý do người viết tài liệu kỹ thuật và lập trình viên chuộng nó.
Hầu hết trình soạn thảo Markdown hiện đại đều hỗ trợ *GitHub-Flavored Markdown* (GFM), bổ sung bảng, danh sách công việc, khối code có gợi ý ngôn ngữ, tự động tạo liên kết và gạch ngang chữ bên trên đặc tả CommonMark gốc.
Những điều bạn sẽ học được khi dùng trình soạn thảo Markdown
Markdown là văn bản thuần: đọc được ngay trong trình soạn thảo *và* hiển thị được thành HTML, không cần thanh công cụ hay định dạng ẩn.
Tiêu đề, danh sách, liên kết và chữ nhấn mạnh đáp ứng 90% nhu cầu viết thông thường. Bảng và khối code đáp ứng gần hết 10% còn lại.
Khối code có gợi ý ngôn ngữ (```js, ```python) sẽ bật tô màu cú pháp trong nhiều trình hiển thị.
Markdown được chuyển sang HTML lúc hiển thị. Cùng một mã nguồn cho ra kết quả nhất quán ở mọi nơi dùng trình hiển thị CommonMark/GFM.
Cách dùng trình soạn thảo Markdown từng bước
1
Bắt đầu gõ ở khung bên trái
Dùng # cho tiêu đề, * hoặc _ để nhấn mạnh, - cho danh sách. Khung bên phải cập nhật ngay khi bạn gõ.
2
Thêm cấu trúc
Chèn tiêu đề, khối code và bảng để sắp xếp tài liệu. Hầu hết trình soạn thảo có phím tắt (Ctrl+B, Ctrl+I) cho các định dạng thường dùng.
3
Xem trước HTML đã hiển thị
So sánh bản xem trước trực tiếp với mã nguồn. Nếu có gì đó hiển thị không như mong đợi, mã nguồn thường thiếu một dòng trống hoặc có rào code không khớp.
4
Sao chép hoặc tải xuống
Sao chép mã nguồn Markdown vào README, hoặc sao chép HTML vào email, CMS hay bất cứ nơi nào không hiểu Markdown.
Dấu gạch đứng (|) phân tách các cột. Dòng gạch ngang phân định cột, còn ký tự : đặt căn lề (trái, giữa, phải). Bảng GFM không cần độ rộng cột chính xác: chỉ cấu trúc là quan trọng.
GitHub hiển thị chúng thành các ô đánh dấu tương tác trong issue và PR. Hữu ích cho danh sách kiểm tra ngay trong tài liệu và theo dõi dự án đơn giản.
Những lỗi Markdown thường gặp
Quên dòng trống quanh danh sách, bảng và khối code. Hầu hết trình hiển thị cần một dòng trống để bắt đầu khối mới.
Trộn tab và dấu cách trong danh sách: một số trình hiển thị sẽ âm thầm làm hỏng thụt lề.
Đặt HTML thô trong khối code và mong nó được hiển thị. Khối code giữ nguyên *từng ký tự*, đó chính là mục đích.
Cho rằng mọi Markdown đều giống nhau. CommonMark, GFM và các biến thể khác khác nhau ở những điểm tinh tế (xuống dòng, tự động tạo liên kết, HTML nhúng).
Dùng > để thụt lề thay vì để trích dẫn. > *nghĩa là* trích dẫn: hãy chọn cách thụt lề khác.
Câu hỏi thường gặp về trình soạn thảo Markdown
Markdown là gì?
Markdown là ngôn ngữ đánh dấu gọn nhẹ, chuyển cú pháp văn bản thuần đơn giản (# heading, **bold**, [link](url)) thành HTML đã định dạng. Nó được thiết kế để dễ đọc ngay ở dạng mã nguồn.
Làm sao chuyển Markdown sang HTML?
Dán Markdown vào trình soạn thảo Markdown rồi sao chép HTML đã hiển thị, hoặc chạy một công cụ chuyển đổi như marked, markdown-it hay pandoc. Hầu hết trình tạo trang tĩnh tự làm việc này lúc build.
Markdown và GitHub-Flavored Markdown khác nhau thế nào?
GitHub-Flavored Markdown (GFM) bổ sung bảng, khối code có gợi ý ngôn ngữ, danh sách công việc, tự động tạo liên kết và gạch ngang chữ bên trên Markdown chuẩn. Đây là phương ngữ được GitHub, GitLab và nhiều nền tảng tài liệu dùng.
Có thể dùng HTML trong Markdown không?
Có. Hầu hết trình hiển thị cho HTML thô đi qua. Cách này hữu ích để nhúng những thứ Markdown không hỗ trợ sẵn (bố cục tùy chỉnh, thẻ video), nhưng nó khiến tài liệu của bạn phụ thuộc vào đầu ra HTML.
Trình soạn thảo Markdown có riêng tư không?
Có. Trình soạn thảo của Coddy hiển thị Markdown hoàn toàn trong trình duyệt của bạn: văn bản không được tải lên đâu cả.