Markdown là một ngôn ngữ đánh dấu nhẹ được sử dụng rộng rãi để format text. Đây là hướng dẫn chi tiết về các cú pháp Markdown cơ bản mà bạn có thể sử dụng khi viết blog hoặc documentation.

Tiêu đề (Headings)

Các element HTML <h1>—<h6> đại diện cho 6 level tiêu đề khác nhau. <h1> là level cao nhất, <h6> là thấp nhất.

H1 - Tiêu đề chính

H2 - Tiêu đề phụ

H3 - Tiêu đề con

H4 - Tiêu đề nhỏ

H5 - Tiêu đề rất nhỏ

H6 - Tiêu đề nhỏ nhất

Đoạn văn (Paragraph)

Văn bản thông thường sẽ được render thành các đoạn văn. Bạn có thể viết nhiều dòng liên tiếp và chúng sẽ được gộp thành một đoạn.

Để tạo đoạn văn mới, hãy để trống một dòng giữa các đoạn.

Markdown hỗ trợ in đậm, in nghiêng, và code inline ngay trong đoạn văn. Bạn cũng có thể tạo strikethrough và ==highlight== text.

Hình ảnh (Images)

Cú pháp

![Alt text](./duong/dan/den/hinh/anh)
![Mô tả hình](URL_hoặc_đường_dẫn_hình)

Kết quả

Bạn có thể thêm title cho hình ảnh:

![Mô tả hình](URL "Title hiển thị khi hover")

Trích dẫn (Blockquotes)

Element blockquote đại diện cho nội dung được trích dẫn từ nguồn khác.

Trích dẫn đơn giản

Cú pháp

> Code is like humor. When you have to explain it, it's bad.
> **Lưu ý** rằng bạn có thể sử dụng _cú pháp Markdown_ trong blockquote.

Kết quả

Code is like humor. When you have to explain it, it’s bad. Lưu ý rằng bạn có thể sử dụng cú pháp Markdown trong blockquote.

Trích dẫn có nguồn

Cú pháp

> "The best way to predict the future is to invent it."<br>
> — <cite>Alan Kay</cite>

Kết quả

“The best way to predict the future is to invent it.”
— Alan Kay

Bảng (Tables)

Cú pháp

| Tính năng | Mô tả        | Hỗ trợ |
| --------- | ------------ | ------ |
| **Bold**  | In đậm       | ✅     |
| *Italic*  | In nghiêng   | ✅     |
| `Code`    | Code inline  | ✅     |

Kết quả

Tính năng	Mô tả	Hỗ trợ
Bold	In đậm	✅
Italic	In nghiêng	✅
Code	Code inline	✅

Căn chỉnh trong bảng

| Left | Center | Right |
|:-----|:------:|------:|
| L1   |   C1   |    R1 |
| L2   |   C2   |    R2 |

Left	Center	Right
L1	C1	R1
L2	C2	R2

Code Blocks

Inline Code

Sử dụng backticks để tạo inline code. Ví dụ: const x = 1;

Code Blocks

Cú pháp

```javascript
function greetUser(name) {
    console.log(`Xin chào, ${name}!`);
    return `Hello ${name}!`;
}

greetUser("BopBap");
```

Kết quả

function greetUser(name) {
    console.log(`Xin chào, ${name}!`);
    return `Hello ${name}!`;
}

greetUser("BopBap");

Syntax Highlighting

Markdown hỗ trợ syntax highlighting cho nhiều ngôn ngữ:

# Python
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

print(fibonacci(10))

# Bash
#!/bin/bash
echo "Hello World!"
for i in {1..5}; do
    echo "Number: $i"
done

-- SQL
SELECT users.name, posts.title
FROM users
INNER JOIN posts ON users.id = posts.user_id
WHERE posts.published = true
ORDER BY posts.created_at DESC
LIMIT 10;

Danh sách (Lists)

Danh sách có thứ tự

Cú pháp

1. Bước đầu tiên
2. Bước thứ hai
3. Bước cuối cùng

Kết quả

1. Bước đầu tiên
2. Bước thứ hai
3. Bước cuối cùng

Danh sách không thứ tự

Cú pháp

- Mục thứ nhất
- Mục thứ hai
- Mục thứ ba

Kết quả

• Mục thứ nhất
• Mục thứ hai
• Mục thứ ba

Danh sách lồng nhau

Cú pháp

- Công nghệ Frontend
  - HTML5
  - CSS3
  - JavaScript
    - Vanilla JS
    - React
    - Vue.js
- Công nghệ Backend
  - Node.js
  - Python
  - Go

Kết quả

• Công nghệ Frontend
  • HTML5
  • CSS3
  • JavaScript
    • Vanilla JS
    • React
    • Vue.js
• Công nghệ Backend
  • Node.js
  • Python
  • Go

Task Lists

- [x] Hoàn thành setup project
- [x] Viết documentation
- [ ] Deploy lên production
- [ ] Viết unit tests

• Hoàn thành setup project
• Viết documentation
• Deploy lên production
• Viết unit tests

Links

Cú pháp cơ bản

[Văn bản hiển thị](URL)
[Google](https://google.com)
[Email tôi](mailto:contact@bopbap.co)

Kết quả

Google Email tôi

Reference Links

Tôi thường xuyên sử dụng [Google][1] và [GitHub][2] để làm việc.

[1]: https://google.com "Google Search"
[2]: https://github.com "GitHub Platform"

Tôi thường xuyên sử dụng Google và GitHub để làm việc.

Các element khác

Horizontal Rule

---
hoặc
***

---

Emojis

Markdown hỗ trợ emoji shortcodes:

:smile: :heart: :thumbsup: :rocket: :computer:

😄 ❤️ 👍 🚀 💻

HTML Elements

Bạn có thể sử dụng HTML trực tiếp trong Markdown:

<abbr title="HyperText Markup Language">HTML</abbr> là ngôn ngữ đánh dấu.

H<sub>2</sub>O là công thức của nước.

E = mc<sup>2</sup> là công thức Einstein.

Nhấn <kbd>Ctrl</kbd> + <kbd>C</kbd> để copy.

<mark>Văn bản được highlight</mark>

HTML là ngôn ngữ đánh dấu.

H₂O là công thức của nước.

E = mc² là công thức Einstein.

Nhấn Ctrl + C để copy.

Văn bản được highlight

Tips cho việc viết Markdown hiệu quả

1. Sử dụng editor có hỗ trợ

• VS Code với extension “Markdown All in One”
• Typora cho WYSIWYG editing
• Obsidian cho note-taking

2. Preview thường xuyên

• Sử dụng split view để xem kết quả real-time
• Test trên các platform khác nhau (GitHub, GitLab, etc.)

3. Conventions

• Sử dụng 2 spaces cho indentation trong lists
• Để trống 1 dòng giữa các sections
• Sử dụng consistent heading structure

4. Advanced Features

• Table of Contents tự động
• Math equations với LaTeX
• Diagrams với Mermaid
• Footnotes và references

Kết luận

Markdown là tool mạnh mẽ và dễ học cho việc viết content. Với những cú pháp cơ bản này, bạn có thể tạo ra documents chuyên nghiệp và dễ đọc.

Remember: Practice makes perfect! Hãy thực hành thường xuyên để master Markdown syntax. 📝