Bạn mở một file README.md trên GitHub và thấy toàn dấu # với ** rải rác. Hoặc đang bình luận trong một công cụ nào đó thì thấy dòng nhỏ "hỗ trợ Markdown" mà chẳng biết gõ kiểu gì để ra chữ đậm. Cũng có khi bạn ghi chú trong Notion/Obsidian, viết tài liệu kỹ thuật, hay chuẩn bị nội dung đưa cho chatbot AI đọc — và nhận ra ai cũng nhắc tới Markdown như chuyện hiển nhiên, chỉ riêng bạn là còn ngờ ngợ.

Tin tốt: Markdown không phải "ngôn ngữ lập trình" đáng sợ. Nó chỉ là cách gõ vài ký tự đặc biệt vào văn bản thuần (plain text, không cần Word) để đánh dấu tiêu đề, đậm, danh sách, liên kết... rồi để phần mềm khác hiển thị đẹp giúp bạn. Bài này giải thích cú pháp cơ bản, rồi đi thẳng vào việc: gõ thử, xem trước, chuyển đổi qua lại giữa Markdown với HTML hay tài liệu Word/PDF.

Thử ngay không cần đọc lý thuyết: mở công cụ xem trước Markdown, dán vài dòng có # hoặc **chữ đậm** vào, bạn sẽ thấy kết quả hiện ra tức thì ở khung bên cạnh. Không cần cài phần mềm, không cần đăng nhập.

Vì sao Markdown được dùng khắp nơi

Markdown chỉ là văn bản thuần nên nhẹ, gõ đâu cũng được, và đặc biệt hợp để lưu trên Git — text thuần thì diff (so sánh thay đổi) rất rõ ràng, không như file Word nhị phân. Đó là lý do README của gần như mọi dự án trên GitHub, wiki nội bộ, ghi chú Notion/Obsidian, và tài liệu kỹ thuật đều dùng Markdown mặc định. Nó cũng là định dạng mà AI/chatbot đọc-viết tự nhiên nhất, vì cấu trúc rõ ràng mà gọn hơn HTML.

Cú pháp cơ bản chỉ có chừng này, học một lần là nhớ:

Cú phápKết quả# Tiêu đềTiêu đề lớn nhất (H1)## Tiêu đềTiêu đề cấp 2 (H2)**chữ đậm**chữ đậm*chữ nghiêng*chữ nghiêng- mục danh sáchDanh sách gạch đầu dòng1. mục danh sáchDanh sách đánh số[nhãn](https://url.vn)Liên kết`đoạn code`Code inline> trích dẫnKhối trích dẫn| cột 1 | cột 2 |Bảng

Một đoạn Markdown thật trông như thế này:

# Hướng dẫn cài đặt

Dự án này chạy trên Node.js 20+.

## Bước 1 — Cài dependency

Chạy lệnh `pnpm install`, sau đó `pnpm dev` để khởi động.

- Xem log tại `logs/app.vn.log`
- Xem thêm tại [tài liệu chi tiết](https://docs.congtyabc.vn)

Chỉ với chừng đó ký tự, một trình đọc Markdown (GitHub, Notion, hay công cụ bên dưới) sẽ tự dựng thành tiêu đề, danh sách, khối code và liên kết có định dạng đàng hoàng — không cần bạn bôi đen rồi bấm nút B/I như Word.

Bộ công cụ viết, xem trước và chuyển đổi Markdown

Bước 1 — Gõ thử để quen cú pháp (trình soạn có toolbar + xem trước)

Cách học Markdown nhanh nhất không phải đọc bảng cú pháp, mà là gõ và thấy kết quả ngay. Trình soạn Markdown có sẵn toolbar (đậm, nghiêng, tiêu đề, liên kết, code, trích dẫn, danh sách) để bạn bấm thay vì nhớ ký tự, cùng 3 chế độ xem: Soạn thảo, Xem trước, Chia đôi (gõ trái, thấy kết quả phải cùng lúc) — kèm đếm ký tự.

Chỉ cần dán một đoạn có sẵn để xem nó hiển thị ra sao thì dùng công cụ xem trước Markdown nhanh hơn — dán vào render ngay, có tab xem nội dung thô, đếm từ/ký tự, và văn bản mẫu để thử nếu chưa có sẵn nội dung.

Lỗi hay gặp:

  • Quên dòng trống giữa các đoạn hoặc trước/sau danh sách — hai dòng viết liền nhau không có dòng trống sẽ bị dính thành một đoạn, danh sách viết sát đoạn văn phía trên có khi không được nhận ra là danh sách. Cứ để một dòng trống giữa các "khối" nội dung (tiêu đề, đoạn văn, danh sách, khối code) là an toàn nhất.

  • Quên khoảng trắng sau dấu # — gõ #Tiêu đề (dính liền) sẽ không ra tiêu đề, phải là # Tiêu đề có dấu cách.

Bước 2 — Viết tài liệu thật rồi xuất ra .md hoặc HTML

Khi đã quen tay, bạn viết hẳn một README, tài liệu hướng dẫn, hay ghi chú dài trong Trình soạn Markdown. Công cụ xuất kết quả theo cả hai chiều: sao chép/tải file .md thuần (đưa vào Git, Notion, Obsidian...), hoặc lấy luôn HTML để dán trực tiếp vào website hay CMS không hiểu cú pháp Markdown.

Ví dụ: viết xong bài hướng dẫn kỹ thuật bằng Markdown cho gọn, rồi cần đăng lên trang tin nội bộ blog.congtyabc.vn — chuyển sang chế độ xuất HTML, sao chép rồi dán thẳng vào ô soạn bài CMS, không phải gõ lại.

Lỗi hay gặp:

  • Dán nguyên văn Markdown (còn dấu #, **) vào nơi chỉ nhận HTML — trang sẽ hiển thị y nguyên các ký tự #/** xấu xí thay vì tiêu đề/chữ đậm. Nhớ chuyển sang bản xuất HTML trước khi dán vào CMS hay email.

  • Nhầm giữa các "flavor" Markdown — không phải nơi nào cũng hỗ trợ mọi cú pháp giống nhau. Bảng và checkbox (- [ ]) chạy tốt trên GitHub, nhưng một số CMS hoặc diễn đàn cũ chỉ hiểu cú pháp cơ bản (tiêu đề, đậm, nghiêng, liên kết). Nếu dán vào chỗ lạ mà bảng không hiện ra đúng, thử xuất bản HTML thay vì Markdown thô.

Bước 3 — Có sẵn nội dung HTML, muốn đưa vào wiki dạng Markdown

Ngược lại, có sẵn một trang HTML (chép từ website cũ, hay xuất từ công cụ khác) và muốn đưa vào wiki/README chỉ nhận Markdown, dùng công cụ chuyển HTML sang Markdown. Dán mã HTML vào, công cụ trả Markdown tương ứng, với 3 tuỳ chọn: Giữ liên kết, Giữ hình ảnh, Chuẩn hoá tiêu đề — bật/tắt tuỳ nhu cầu. Chưa có HTML để thử thì bấm nút ví dụ có sẵn.

Lỗi hay gặp:

  • HTML có nhiều thẻ lồng nhau, CSS inline — kết quả Markdown có thể giữ lại cấu trúc không cần thiết. Tắt bớt tuỳ chọn không cần (ví dụ bỏ giữ hình ảnh nếu chỉ cần chữ) rồi kiểm tra lại phần xem trước.

  • Quên kiểm tra liên kết sau khi chuyển — HTML gốc dùng đường dẫn tương đối (/bai-viet/abc thay vì https://trangweb.vn/bai-viet/abc) thì Markdown ra cũng giữ nguyên dạng đó, không bấm được ở nơi khác.

Bước 4 — Tài liệu Word/PDF cần chuyển sang Markdown

Nhiều tài liệu kỹ thuật hay quy trình nội bộ vẫn nằm ở dạng Word, PDF hoặc PowerPoint — đưa vào wiki dạng Markdown mà gõ lại tay thì rất mất công. Công cụ chuyển tài liệu sang Markdown giải quyết đúng việc này: kéo-thả file PDF, DOCX, PPTX, XLSX, XLS hoặc DOC (tối đa 50MB) vào, công cụ trả nội dung dạng Markdown. File tải lên được xoá ngay sau khi chuyển đổi, không lưu lại trên máy chủ.

Lỗi hay gặp:

  • File vượt quá 50MB — công cụ báo không xử lý được. Tài liệu quá nặng (thường do nhúng nhiều ảnh độ phân giải cao) thì tách bớt phần cần chuyển hoặc nén file trước khi tải lên.

  • Bảng biểu phức tạp trong Word/Excel bị "vỡ" cấu trúc khi ra Markdown — cú pháp bảng Markdown đơn giản hơn nhiều so với bảng có ô gộp (merge cells). Nên kiểm tra lại phần bảng sau khi chuyển thay vì tin tưởng tuyệt đối.

Kỳ vọng: mất bao lâu, dùng bước nào khi nào

  • Viết/xem trước/chuyển đổi Markdown ↔ HTML: xử lý ngay trên trình duyệt, gần như tức thì khi bạn gõ hoặc dán nội dung.

  • Chuyển tài liệu Word/PDF/PPTX/Excel sang Markdown: thời gian phụ thuộc kích thước và số trang của file, thường vài giây tới khoảng một phút với tài liệu vài chục trang.

  • Chọn bước nào: mới học cú pháp → Bước 1 (gõ thử + xem trước chia đôi); đã viết xong cần xuất ra dùng → Bước 2; có HTML cũ cần đưa vào wiki/README → Bước 3; có sẵn file Word/PDF/PPTX/Excel → Bước 4.

Tất cả đều chạy ngay trên trình duyệt, miễn phí và không giới hạn số lần dùng trong ngày.

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

Markdown khác gì HTML? HTML là ngôn ngữ đánh dấu đầy đủ cho trình duyệt, nhiều thẻ và phức tạp hơn. Markdown là cú pháp rút gọn, dễ gõ tay, sau đó được các công cụ (như Trình soạn Markdown) chuyển thành HTML khi cần hiển thị lên web.

File .md cần phần mềm riêng để mở không? Không bắt buộc — file .md thực chất là văn bản thuần, mở được bằng bất kỳ trình soạn thảo text nào. Nhưng để xem đúng định dạng (tiêu đề, đậm, danh sách) thay vì thấy nguyên ký tự #/**, bạn cần một trình đọc Markdown như công cụ xem trước.

Bảng và checkbox trong Markdown có chạy được ở mọi nơi không? Không phải lúc nào cũng vậy. Cú pháp cơ bản (tiêu đề, đậm, nghiêng, liên kết) thì gần như nơi nào cũng hỗ trợ, nhưng bảng hay checkbox (- [ ]) là phần mở rộng — GitHub hỗ trợ tốt, một vài CMS hoặc diễn đàn cũ thì không. Gặp trường hợp này, thử xuất bản HTML thay vì dán Markdown thô.

Chuyển tài liệu Word/PDF sang Markdown có giữ được định dạng gốc không? Giữ được phần lớn cấu trúc (tiêu đề, danh sách, đoạn văn, bảng đơn giản), nhưng Markdown đơn giản hơn Word/PDF nên trang trí phức tạp (màu chữ, ô gộp, layout nhiều cột) không giữ nguyên 100%. Nên xem lại bản Markdown sau khi chuyển, nhất là tài liệu nhiều bảng.

BKNS Tools — bộ công cụ viết, xem trước và chuyển đổi Markdown miễn phí. Trình soạn Markdown · Xem trước Markdown · HTML sang Markdown · Tài liệu sang Markdown — không cần đăng nhập.