Menu

Trình soạn thảo Markdown

Viết Markdown với bản xem trước chia đôi màn hình trực tiếp.

Tác giả Nethanel Bar, Co-founder & CEO

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

Sẵn sàng học code thật sự?

Coddy dạy bạn bằng cách viết code thật ngay trên trình duyệt: bài học tương tác, phản hồi tức thì và AI hỗ trợ khi bạn bị kẹt.

Trình soạn thảo Markdown là gì?

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.

Cheat sheet cú pháp Markdown

80% Markdown bạn sẽ dùng hằng ngày. Phần còn lại chỉ cần tìm trên Google. Đặc tả: CommonMark và GitHub-Flavored Markdown.

Thành phầnMarkdownHiển thị thành
Tiêu đề 1# TitleTiêu đề cấp cao nhất
Tiêu đề 2## SectionTiêu đề mục
In đậm**strong****strong**
In nghiêng*emphasis* hoặc _emphasis_*emphasis*
Code trong dòng`code`code
Khối codeBọc code trong rào ba dấu backtick, có thể kèm gợi ý ngôn ngữKhối code được tô màu cú pháp
Liên kết[label](https://example.com)Liên kết nhấp được
Hình ảnh![alt](url)Hình ảnh nhúng
Danh sách- itemDanh sách gạch đầu dòng
Danh sách đánh số1. itemDanh sách có thứ tự
Danh sách công việc (GFM)- [x] doneÔ đã đánh dấu
Bảng (GFM)| a | b |\n|---|---|\n| 1 | 2 |Bảng hai cột
Trích dẫn> quoteĐoạn trích dẫn thụt lề

Ví dụ Markdown để thử

Phần mở đầu README điển hình

Mã nguồn
# Project Name
A short description in one or two sentences.
## Install
```bashnpm install project-name```
## Quick start
- Step 1- Step 2- Step 3

Tiêu đề, đoạn văn, lệnh cài đặt trong khối code và một danh sách gạch đầu dòng: đó là xương sống của mọi README tốt.

Bảng (GitHub-flavored)

Mã nguồn
| Feature | Free | Pro ||---------|:----:|:---:|| Editor  |  ✓   |  ✓  || Export  |      |  ✓  |

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.

Danh sách công việc

Mã nguồn
- [x] Draft the post- [x] Add screenshots- [ ] Publish

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ả.

Tìm hiểu thêm

Công cụ lập trình khác

Hình minh họa các ngôn ngữ lập trình của Coddy

Học lập trình cùng Coddy

Bắt đầu