Trình soạn thảo Markdown
Viết Markdown ở bên trái và bản xem trước đã định dạng sẽ hiện ở bên phải. Những gì bạn nhập không rời khỏi trình duyệt của bạn.
Dùng in đậm, in nghiêng, gạch ngang, mã nội dòng và liên kết. Chọn một từ và nhấn Ctrl+B để in đậm.
Mẹo: dán văn bản từ Word, Google Docs hoặc một trang web và định dạng sẽ chuyển thành Markdown.
- Lên kế hoạch phát hành
- Viết nhật ký thay đổi
- Ghi thay đổi không tương thích lên đầu
- Phát hành chính thức
- Mở một tệp
.md - Sửa văn bản
- Tải xuống dạng PDF, Word hoặc HTML
- Soạn dàn ý
- Xem lại cùng nhóm
| Cú pháp | Kết quả |
|---|---|
**đậm** |
đậm |
*nghiêng* |
nghiêng |
[^1] |
một chú thích |
function greet(name) {
return `Hello, ${name}!`;
}
Chú thích được đánh số tự động.1
-
Chúng được liệt kê ở cuối bản xem trước và ở cuối mọi tệp xuất ra. ↩︎
171 từ · 837 ký tự · 1 phút đọc
Phím tắt
| Ctrl+B | In đậm |
| Ctrl+I | In nghiêng |
| Ctrl+K | Liên kết |
| Enter | Tiếp tục danh sách hoặc trích dẫn; nhấn ở mục trống để kết thúc |
| Tab / Shift+Tab | Thụt lề hoặc giảm thụt lề mục danh sách |
| Ctrl+S | Tải xuống tệp .md |
| Ctrl+Shift+V | Dán mà không chuyển đổi định dạng |
Trình soạn thảo Markdown online này hiển thị văn bản của bạn ở bên trái, kết quả đã định dạng ở bên phải, và bản xem trước thay đổi theo từng phím bạn nhấn. Công cụ hiểu Markdown theo cách dùng trên GitHub, trong các tệp README, wiki và những ứng dụng ghi chú như Obsidian: tiêu đề, danh sách, danh sách công việc, bảng, mã, trích dẫn, liên kết, hình ảnh và chú thích. Bạn không cần tài khoản, và những gì bạn nhập không được gửi đi đâu cả.
Cách dùng trình soạn thảo Markdown online
- Nhập hoặc dán Markdown vào ô bên trái, hoặc mở một tệp .md bằng nút mở tệp trên thanh công cụ. Bạn cũng có thể thả tệp vào bất kỳ chỗ nào trên trình soạn thảo.
- Theo dõi bản xem trước ở bên phải. Cuộn đồng bộ giữ hai bên ở cùng một phần của tài liệu, dù bạn cuộn bên nào.
- Định dạng văn bản bằng thanh công cụ hoặc bằng phím tắt, chẳng hạn Ctrl+B để in đậm và Ctrl+K để chèn liên kết.
- Sao chép kết quả dưới dạng Markdown, HTML hoặc văn bản có định dạng, hoặc tải xuống thành tệp .md, .pdf, .docx, .html hay .txt.
Trình soạn thảo mở sẵn một ví dụ ngắn tên là “Ghi chú dự án” có dùng mọi thành phần phổ biến, để bạn thấy cú pháp và kết quả của nó cạnh nhau trước khi tự viết.
Trình soạn thảo Markdown có xem trước trực tiếp
Phía trên trình soạn thảo có ba chế độ xem. Song song đặt Markdown và bản xem trước cạnh nhau, Soạn thảo dành toàn bộ chiều rộng cho văn bản, còn Xem trước chỉ hiển thị kết quả, đóng vai trò một trình xem Markdown đơn giản cho tệp ai đó gửi cho bạn. Trên điện thoại, trình soạn thảo chuyển qua lại giữa Soạn thảo và Xem trước, vì hai cột sẽ quá hẹp để đọc.
Bản xem trước được hiển thị theo cách GitHub hiển thị Markdown: CommonMark cùng các phần mở rộng GitHub Flavored Markdown (cả hai bằng tiếng Anh), vốn bổ sung bảng, danh sách công việc, chữ gạch ngang và liên kết tự động. Tiêu đề có neo (anchor) như trên GitHub, nên ## Kế hoạch phát hành có thể được liên kết bằng #kế-hoạch-phát-hành, và khi nhấp vào liên kết như vậy, bản xem trước sẽ cuộn tới tiêu đề đó. Chú thích viết dạng [^1] được đánh số theo thứ tự bạn nhắc đến lần đầu và được liệt kê ở cuối.
Ô văn bản dùng tính năng kiểm tra chính tả của trình duyệt, nên từ viết sai được gạch chân ngay khi bạn viết. Bên dưới trình soạn thảo, bạn thấy số từ, số ký tự và thời gian đọc. Các con số này không tính cú pháp Markdown, nên một tiêu đề đánh dấu bằng ## chỉ được tính các từ của nó. Để đếm cả câu và đoạn văn, hãy dán văn bản vào công cụ đếm từ và ký tự.
Thanh công cụ và phím tắt
Thanh công cụ có mọi thứ bạn cần cho một tài liệu thông thường: Tiêu đề, In đậm, In nghiêng, Gạch ngang chữ, Mã nội dòng, Liên kết, Hình ảnh, Trích dẫn, Khối mã, Danh sách có dấu đầu dòng, Danh sách đánh số, Danh sách công việc, Bảng và Đường kẻ ngang. Nếu bạn chọn văn bản trước, nút sẽ bọc ký hiệu quanh vùng chọn; nhấn lại chính nút đó thì các ký hiệu biến mất. Khi không có vùng chọn, nút chèn một đoạn giữ chỗ ngắn đã được chọn sẵn, nên bạn chỉ cần gõ đè lên.
Một vài chi tiết giúp tiết kiệm thời gian:
- Tiêu đề lần lượt chuyển dòng hiện tại qua
#,##,###rồi trở lại văn bản thường. - Liên kết biến các từ đã chọn thành
[các từ](https://)và chọn sẵn phần địa chỉ, để bạn dán URL vào. Nếu bạn chọn một URL, URL đó sẽ trở thành địa chỉ. - Các nút danh sách và Trích dẫn tác động lên mọi dòng đã chọn cùng lúc. Nhấn Danh sách đánh số trên một danh sách có dấu đầu dòng sẽ biến nó thành danh sách đánh số.
- Nhấn Enter ở cuối một mục danh sách, mục tiếp theo sẽ bắt đầu bằng ký hiệu phù hợp. Số thứ tự tự tăng, mục công việc mới bắt đầu ở trạng thái chưa đánh dấu, và nhấn Enter trên một mục trống sẽ kết thúc danh sách. Tab và Shift+Tab thụt lề và giảm thụt lề các mục danh sách.
- Mọi thay đổi do nút hoặc phím tắt tạo ra đều có thể hoàn tác bằng Ctrl+Z.
Tất cả phím tắt được liệt kê trong mục Phím tắt bên dưới trình soạn thảo. Trên máy Mac, chúng dùng phím Command.
Dán từ Word hoặc Google Docs để nhận Markdown
Khi bạn dán văn bản sao chép từ Word, Google Docs hoặc một trang web, trình soạn thảo chuyển định dạng của nó thành Markdown thay vì bỏ đi. Tiêu đề thành các dòng #, chữ in đậm và in nghiêng nhận dấu sao, liên kết giữ nguyên địa chỉ, danh sách có dấu đầu dòng và danh sách đánh số (kể cả danh sách nhiều cấp của Word) thành danh sách Markdown, còn bảng thành bảng Markdown với hàng đầu tiên làm hàng tiêu đề. Đây là cách nhanh nhất để đưa một tài liệu có sẵn vào README hoặc trang wiki.
Nếu bạn chỉ cần chữ không kèm định dạng, hãy nhấn Dùng văn bản thuần trong thông báo hiện ra sau khi dán, hoặc dán bằng Ctrl+Shift+V. Mã sao chép từ VS Code hoặc trình soạn thảo mã khác, cũng như văn bản vốn đã là Markdown, được dán nguyên như vậy.
Bảng tóm tắt cú pháp Markdown
Những cú pháp phổ biến nhất trong một bảng. Gõ cột bên trái vào trình soạn thảo để thấy cột bên phải trong bản xem trước.
| Bạn gõ | Bạn nhận được |
|---|---|
# Tiêu đề, ## Phần, ### Mục nhỏ | Tiêu đề cấp 1 đến 3 (tối đa cấp 6 với ######) |
**đậm** và *nghiêng* | đậm và nghiêng |
~~cũ~~ | |
`mã` | mã bằng phông chữ đơn cách |
[văn bản](https://example.com) | một liên kết |
 | một hình ảnh |
- mục hoặc 1. mục | danh sách có dấu đầu dòng hoặc danh sách đánh số |
- [ ] việc và - [x] xong | danh sách công việc có ô đánh dấu |
> văn bản trích dẫn | một trích dẫn |
| ba dấu backtick trên một dòng trước và sau đoạn mã | một khối mã |
--- trên một dòng riêng | một đường kẻ ngang |
văn bản[^1] và [^1]: ghi chú | một chú thích |
Bảng Markdown cần một hàng tiêu đề, một hàng phân cách gồm các dấu gạch, rồi mỗi hàng của bảng nằm trên một dòng, các ô ngăn cách bằng |. Dấu hai chấm trong hàng phân cách quy định cách căn lề: :-- căn trái, :-: căn giữa và --: căn phải. Nút Bảng chèn sẵn một bảng ba cột để bạn bắt đầu. Các ô trong mã nguồn không cần thẳng hàng, nhưng căn thẳng giúp bảng dễ sửa hơn về sau.
Markdown cũng chấp nhận HTML cho những thứ không có cú pháp riêng, chẳng hạn <kbd>Ctrl</kbd> cho phím, <sub> và <sup> cho H₂O và x², hoặc <details> cho một phần mở ra khi nhấp. Script, style và biểu mẫu bị loại khỏi bản xem trước vì lý do an toàn.
Sao chép có định dạng hoặc tải tệp xuống
Sao chép Markdown sao chép mã nguồn, Sao chép HTML sao chép HTML gọn gàng, sẵn sàng cho website hoặc CMS, còn Sao chép có định dạng sao chép kết quả đã định dạng. Khi bạn dán vào Google Docs, Word, Outlook hoặc Gmail, các tiêu đề, chữ in đậm, danh sách, liên kết và bảng đều giữ nguyên định dạng và không còn ký hiệu Markdown nào.
Các nút Tải xuống lưu tài liệu dưới dạng Markdown, PDF, Word, HTML hoặc văn bản thuần chỉ với một cú nhấp, đặt tên theo tiêu đề trong front matter hoặc theo tiêu đề đầu tiên của tài liệu. Chúng dùng các thiết lập mặc định hợp lý: khổ giấy A4 (Letter ở Mỹ, Canada, Mexico và các nước khác dùng khổ này làm chuẩn), lề bình thường và cỡ chữ 11 pt. Để chọn khổ giấy, phông chữ và lề, thêm mục lục hoặc chuyển đổi nhiều tệp cùng lúc, hãy dùng Thêm tùy chọn xuất, nút này mở bộ chuyển đổi Markdown với văn bản của bạn đã được điền sẵn.
Câu hỏi thường gặp
Văn bản của tôi có bị tải lên hoặc lưu ở đâu không?
Không. Bản xem trước, việc chuyển đổi và các tệp tải xuống đều được xử lý trong trình duyệt của bạn, và văn bản không bao giờ được gửi tới máy chủ. Theo mặc định cũng không có gì được lưu lại, nên văn bản sẽ mất khi bạn đóng tab. Nếu bạn đánh dấu Lưu bản nháp trong trình duyệt này, văn bản được lưu trong bộ nhớ của chính trình duyệt sau mỗi thay đổi và xuất hiện lại ở lần truy cập sau. Hãy bỏ đánh dấu trên máy tính dùng chung, việc này cũng xóa bản nháp đã lưu.
Làm sao để mở và xem file .md online?
Nhấn nút mở tệp trên thanh công cụ hoặc thả tệp vào trình soạn thảo, rồi chuyển sang Xem trước để đọc nó như một tài liệu đã định dạng. Tệp đến 20 MB ở dạng UTF-8 hoặc UTF-16 mở được trực tiếp. Hình ảnh trong tệp được hiển thị khi có địa chỉ web đầy đủ; hình ảnh lưu cạnh tệp trên máy tính của bạn thì một trang web không thể tải được.
Trình soạn thảo dùng biến thể Markdown nào?
Trình soạn thảo tuân theo CommonMark (bằng tiếng Anh), tiêu chuẩn chung mà hầu hết công cụ Markdown đều tuân theo, cộng thêm các phần mở rộng của GitHub: bảng, danh sách công việc, chữ gạch ngang, liên kết tự động và chú thích. Văn bản viết cho GitHub, GitLab, Obsidian, Reddit hoặc Discord trông giống hệt ở đây, trừ những tính năng mà các dịch vụ đó thêm vào, như nhắc tên người dùng hay liên kết wiki của Obsidian.
Làm sao để đưa Markdown vào Google Docs?
Nhấn Sao chép có định dạng rồi dán vào tài liệu. Tiêu đề, danh sách, liên kết và bảng giữ nguyên định dạng. Các phiên bản Google Docs gần đây cũng tự đọc được Markdown bằng lệnh dán từ Markdown trong menu Chỉnh sửa, sau khi bạn bật Markdown trong phần tùy chọn của menu Công cụ.
Trình soạn thảo có hỗ trợ sơ đồ Mermaid hoặc công thức toán LaTeX không?
Chưa. Khối Mermaid được hiển thị như một khối mã thông thường, còn công thức viết dạng $...$ vẫn là văn bản thường. Mọi thứ khác của GitHub Flavored Markdown đều được hỗ trợ.
Markdown là gì và ai dùng nó?
Markdown là cách định dạng văn bản thuần bằng một vài ký hiệu, do John Gruber tạo ra năm 2004 để tài liệu vẫn dễ đọc ngay cả trước khi được chuyển sang HTML (xem thêm trên Wikipedia). Lập trình viên dùng nó cho tệp README và tài liệu kỹ thuật, người viết dùng cho ghi chú và bản nháp, còn các công cụ chat AI trả lời bằng Markdown, vì thế câu trả lời của chúng đầy dấu sao và dấu thăng khi dán sang nơi khác.
Các công cụ khác cho văn bản nằm trong mục Văn bản: so sánh hai phiên bản của một tài liệu để xem những gì đã thay đổi, hoặc đổi kiểu chữ của các tiêu đề trong một lần. Lập trình viên sẽ tìm thấy JSON formatter và các công cụ khác trong mục Nhà phát triển.