Cẩm Nang Cú Pháp Markdown Toàn Tập & Kỹ Thuật Xuất Bản PDF

Markdown là ngôn ngữ đánh dấu văn bản nhẹ (Lightweight Markup Language) phổ biến nhất thế giới hiện nay. Từ các kho mã nguồn trên GitHub, tài liệu kỹ thuật phần mềm, ứng dụng ghi chú thứ hai (Second Brain) như Obsidian, Notion, Logseq cho đến đầu ra của các trí tuệ nhân tạo như ChatGPT, Claude, Gemini — tất cả đều sử dụng Markdown làm tiêu chuẩn cốt lõi.

Tài liệu chuyên sâu này sẽ giúp bạn làm chủ hoàn toàn từ cú pháp chuẩn CommonMark đến GitHub Flavored Markdown (GFM), đồng thời hướng dẫn các bí quyết tối ưu hóa bố cục trang in A4 khi xuất file PDF trên MD Converter.

1. Hệ Thống Tiêu Đề Phân Cấp (Headings H1 – H6)

Cấu trúc một tài liệu khoa học hoặc báo cáo kỹ thuật luôn bắt đầu bằng hệ thống tiêu đề rõ ràng. Trong Markdown, bạn sử dụng ký tự dấu thăng (#) ở đầu dòng, theo sau là một khoảng trắng:

# Tiêu đề cấp 1 (Tương đương thẻ H1 - Tên tài liệu)
## Tiêu đề cấp 2 (Tương đương thẻ H2 - Chương/Phần lớn)
### Tiêu đề cấp 3 (Tương đương thẻ H3 - Mục con)
#### Tiêu đề cấp 4 (H4)
##### Tiêu đề cấp 5 (H5)
###### Tiêu đề cấp 6 (H6)

Quy tắc chuẩn SEO & In ấn: Mỗi tài liệu chỉ nên có duy nhất một tiêu đề # H1 ở trên cùng để định danh chủ đề chính. Các phần tiếp theo nên phân bổ tuần tự từ ## H2 xuống ### H3 mà không nhảy cóc cấp độ.

2. Định Dạng Kiểu Chữ & Nhấn Mạnh (Emphasis)

Để làm nổi bật thông tin quan trọng trong đoạn văn, bạn có thể kết hợp linh hoạt các ký tự dấu sao (*), gạch dưới (_) hoặc dấu ngã (~):

• In nghiêng (Italics): Bao bọc từ bằng 1 dấu sao hoặc 1 dấu gạch dưới: *từ khóa* → từ khóa.
• In đậm (Bold): Bao bọc bằng 2 dấu sao: **quan trọng** → quan trọng.
• Vừa đậm vừa nghiêng: Bao bọc bằng 3 dấu sao: ***đặc biệt chú ý*** → đặc biệt chú ý.
• Gạch ngang chữ (Strikethrough - GFM): Bao bọc bằng 2 dấu ngã: ~~nội dung cũ đã bỏ~~ → nội dung cũ đã bỏ.
• Chỉ số trên và chỉ số dưới (HTML nội dòng): Bạn có thể dùng trực tiếp H<sub>2</sub>O (H₂O) hoặc X<sup>2</sup> (X²).

3. Danh Sách Đa Cấp & Danh Sách Công Việc (Lists & Task Lists)

Markdown hỗ trợ tạo danh sách lồng nhau (Nested Lists) cực kỳ trực quan bằng cách thụt lề 2 hoặc 4 khoảng trắng ở dòng con:

1. Giai đoạn Khảo sát & Thiết kế
   - Phân tích yêu cầu hệ thống
   - Thiết kế sơ đồ cơ sở dữ liệu
2. Giai đoạn Phát triển (Development)
   - [x] Xây dựng giao diện người dùng (Đã hoàn thành)
   - [ ] Tích hợp xuất bản PDF (Đang thực hiện)

4. Bảng Dữ Liệu Nâng Cao & Căn Lề Cột (GFM Tables)

Một trong những tính năng mạnh mẽ nhất của GitHub Flavored Markdown trên MD Converter là khả năng vẽ bảng và điều khiển căn lề (Trái, Giữa, Phải) cho từng cột bằng dấu hai chấm (:) ở dòng phân cách thứ hai:

| Tên tham số | Kiểu dữ liệu | Giá trị mặc định | Mô tả chi tiết |
| :--- | :---: | ---: | :--- |
| `margin` | Number | `10` | Lề trang in tính bằng milimet (Căn phải) |
| `format` | String | `'a4'` | Khổ giấy chuẩn quốc tế (Căn giữa) |
| `scale` | Number | `2` | Độ nét điểm ảnh khi kết xuất (Căn phải) |

• :--- — Căn lề trái (Mặc định).
• :---: — Căn giữa cột (Rất hữu ích cho cột mã code, trạng thái hoặc đơn vị).
• ---: — Căn lề phải (Chuẩn mực kế toán cho các cột chứa số liệu, tiền tệ, phần trăm).

5. Khối Mã Nguồn & Trích Dẫn (Fenced Code Blocks & Blockquotes)

Đối với tài liệu kỹ thuật công nghệ thông tin, việc tách biệt đoạn mã nguồn khỏi văn bản giải thích là bắt buộc:

• Inline Code: Đặt lệnh ngắn trong cặp dấu huyền đơn (backtick) như `git commit -m "init"`.
• Fenced Code Block: Sử dụng 3 dấu backtick (```) ở dòng mở đầu và dòng kết thúc. Bạn có thể ghi tên ngôn ngữ (js, python, sql, bash, json) ngay sau 3 dấu backtick đầu tiên để định danh ngữ nghĩa cho khối lệnh.
• Blockquote: Đặt dấu > ở đầu dòng để tạo khung ghi chú nổi bật với viền trái màu xanh ngọc lục bảo đặc trưng.

6. Bí Quyết Tối Ưu Hóa Bố Cục Khi Xuất File PDF

Khi chuyển đổi từ định dạng văn bản cuộn vô tận trên web sang các trang giấy vật lý khổ A4 (210mm × 297mm), bạn có thể áp dụng các kỹ thuật chuyên sâu sau ngay trong khung soạn thảo của MD Converter:

1. Chủ động ngắt trang (Explicit Page Breaks): Để tránh việc một bảng dữ liệu hoặc một chương mới bị cắt lưng chừng ở cuối trang giấy, hãy đặt đoạn mã <div style="page-break-before: always;"></div> ngay trước tiêu đề chương mới.
2. Giữ độ rộng bảng hợp lý: Trên khổ giấy A4 dọc, một bảng dữ liệu đẹp nhất khi có từ 3 đến 5 cột. Nếu bảng có quá nhiều cột, hãy rút gọn tiêu đề cột để tránh tràn lề phải.
3. Tạo trang bìa báo cáo nhanh: Bạn có thể kết hợp thẻ <div style="text-align: center; margin-top: 80px;"> ở đầu tài liệu để tạo trang bìa căn giữa chuyên nghiệp trước khi ngắt sang trang nội dung chính.