📄
← Quay lại hướng dẫn

Hướng dẫn cú pháp Markdown: Tài liệu tham khảo đầy đủ kèm ví dụ

· Thẻ: markdown-syntax, markdown-guide, markdown-formatting, github-flavored-markdown, markdown-reference

Hướng dẫn cú pháp Markdown

Markdown là một ngôn ngữ đánh dấu nhẹ giúp chuyển đổi văn bản thuần túy sang HTML có định dạng. Được tạo ra bởi John Gruber vào năm 2004, nó đã trở thành định dạng viết tiêu chuẩn cho tài liệu, tệp README và nội dung kỹ thuật trên web.

Tiêu đề

Sử dụng ký hiệu #. Một # cho cấp cao nhất, tối đa sáu cho cấp sâu nhất:

# Tiêu đề 1
## Tiêu đề 2
### Tiêu đề 3
#### Tiêu đề 4

Các cấp nên tăng dần từng bước một — bỏ qua từ ## lên #### có thể gây nhầm lẫn cho trình đọc màn hình.

Định dạng văn bản

**Văn bản in đậm** hoặc __Văn bản in đậm__
*Văn bản in nghiêng* hoặc _Văn bản in nghiêng_
**_In đậm và in nghiêng_**
~~Văn bản gạch ngang~~

Liên kết

[Văn bản liên kết](https://example.com)
[Liên kết có tiêu đề](https://example.com "Tiêu đề")
[Kiểu tham chiếu][ref-id]
[ref-id]: https://example.com
<contact@example.com>

Hình ảnh

![Văn bản thay thế](/path/to/image.jpg)
[![Văn bản thay thế](/path/to/image.jpg)](https://example.com)

Văn bản thay thế rất quan trọng cho khả năng truy cập và SEO — nó hiển thị khi hình ảnh không tải được.

Danh sách

Danh sách không có thứ tự sử dụng -, * hoặc +. Danh sách có thứ tự sử dụng số:

- Mục một          1. Mục đầu tiên
- Mục hai          2. Mục thứ hai
  - Mục lồng nhau     1. Mục lồng nhau

Mã

Mã nội tuyến sử dụng dấu backtick đơn: `printf()`.

Khối mã sử dụng ba dấu backtick với mã định danh ngôn ngữ tùy chọn:

```python
def greet(name):
    return f"Hello, {name}!"


Các ngôn ngữ được hỗ trợ: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## Trích dẫn khối

```markdown
> Đây là một trích dẫn khối.
> > Trích dẫn khối lồng nhau được hỗ trợ.

Thường dùng cho chú thích, ghi chú và trích dẫn nguồn bên ngoài.

Đường kẻ ngang

Ba hoặc nhiều dấu gạch ngang, dấu sao hoặc dấu gạch dưới trên một dòng:

---
***
___

Bảng

Dấu gạch đứng và dấu gạch ngang xác định các cột. Dấu hai chấm kiểm soát căn chỉnh:

| Trái | Giữa | Phải |
| :--- | :--: | ---: |
| A1   | B1   | C1   |

Tiện ích mở rộng GitHub Flavored Markdown

GitHub Flavored Markdown (GFM) bổ sung các tính năng hữu ích:

- [x] Nhiệm vụ đã hoàn thành    # Danh sách nhiệm vụ
- [ ] Nhiệm vụ chưa hoàn thành

:smile: :rocket: :warning:       # Mã emoji

~~Văn bản gạch ngang~~             # Gạch ngang

GFM cũng tự động liên kết URL — www.example.com trở thành có thể nhấp mà không cần bao bọc trong < >.

Thoát ký tự đặc biệt

Thêm tiền tố \ để hiển thị các ký tự Markdown theo nghĩa đen:

\*Đây không phải là in nghiêng\*
\# Đây không phải là tiêu đề

Các ký tự cần thoát: \ ` * _ { } [ ] ( ) # + - . ! | ~.

Xem trước Markdown trực tuyến

Sử dụng công cụ xem trước Markdown để viết và xem trước Markdown theo thời gian thực. Bản xem trước trực tiếp cập nhật khi bạn nhập, hiển thị chính xác cách tiêu đề, liên kết, hình ảnh, khối mã và bảng sẽ được kết xuất.

Hướng dẫn cú pháp Markdown: Tài liệu tham khảo đầy đủ kèm ví dụ - CoolTool