Hướng dẫn Markdown toàn diện trên Louis Space

Trang này hướng dẫn toàn bộ tính năng Markdown mà Louis Space hỗ trợ — mỗi phần đều có ví dụ render thật ngay bên cạnh cú pháp gốc (trang này chính nó được viết bằng Markdown và render bằng đúng engine mà bạn dùng để viết tin tức, mô tả game, hồ sơ và bio).

Dùng ô “Thử ngay” ở đầu trang để gõ Markdown và xem kết quả trực tiếp — tất cả tính năng dưới đây đều thử được ở đó.

Mục lục

1. Định dạng chữ cơ bản

2. Tiêu đề & neo link

Dùng # đến ###### cho 6 cấp tiêu đề. Mỗi tiêu đề có mô tả neo (con trỏ chuột hiện dấu #, bấm để sao chép link đến đúng mục đó).

Bạn có thể tự đặt id cho tiêu đề bằng cú pháp {#id-rieng}:

## Cài đặt nhanh {#cai-dat-nhanh}

Link nội bộ chỉ cần [#cai-dat-nhanh](#cai-dat-nhanh) — xem thử: tới mục Cài đặt nhanh.

3. Danh sách

• Danh sách không thứ tự
• Lồng nhau:
  • Mục con
  • Mục con khác
• Quay lại mức ngoài

1. Danh sách có thứ tự
2. Tự động đánh số

Công việc (task list)

• Học cú pháp cơ bản
• Học bảng
• Viết bài đầu tiên
• Đăng game lên Louis Space

4. Bảng (tự sắp xếp được)

Mọi bảng trong bài viết đều bấm vào tiêu đề cột để sắp xếp (hỗ trợ số kiểu Việt Nam, ngày tháng và chuỗi tiếng Việt):

Canh lề bằng dấu : trong dòng phân tách: |---:| là cột phải, |:---:| là giữa.

5. Code block — highlight + số dòng + copy

Bọc code bằng ba dấu backtick kèm tên ngôn ngữ. Engine tự tô màu cú pháp (hơn 200 ngôn ngữ), đánh số dòng, gắn nhãn ngôn ngữ và nút copy:

fn main() {
    let msg = "Xin chào Louis Space!";
    println!("{msg}");
}

Diff / patch

Dùng ```diff để tô màu dòng thêm/bớt như git diff:

- let score = 0;
+ let score = 100;
@@ config @@

6. Trích dẫn & Callout

Trích dẫn thường — lùi lề với dấu >

Callout dùng cú pháp GitHub [!LOẠI] ngay đầu blockquote:

Ghi chú

Ghi chú — thông tin bổ sung, màu xanh dương.

Mẹo

Mẹo — cách làm nhanh hơn, màu xanh lá.

Cảnh báo

Cảnh báo — dễ gây lỗi, màu cam.

Cẩn thận

Nguy hiểm — có thể mất dữ liệu, màu đỏ.

7. Ẩn nội dung (spoiler)

Dùng ||nội dung|| để làm spoiler — nền đen, rê chuột hoặc bấm mới hiện:

Kết quả trận chung kết: Louis Space thắng 3-1

8. Link & đa phương tiện

• [Chữ hiển thị](https://github.com/mhieuhonda/khogame) — Chữ hiển thị
• Link tới người dùng: gõ @mhieuhonda — @mhieuhonda
• Tag chủ đề: gõ #game-moi — #game-moi

Ảnh

![mô tả](https://example.com/anh.png)
![caption:Ảnh có chú thích](https://example.com/anh.png)

Ảnh có tiền tố caption: trong phần mô tả sẽ hiện chú thích bên dưới. Mọi ảnh tự động lazy-load (chỉ tải khi cuộn tới) và tối ưu async.

Nhúng YouTube & Vimeo

Chỉ cần dán link video đơn độc một dòng — engine tự chuyển thành trình phát nhúng:

https://www.youtube.com/watch?v=dQw4w9WgXcQ
https://vimeo.com/76979871

Nhúng file video / audio trực tiếp

Dán link kết thúc bằng .mp4, .webm, .ogv, .mov, .m4v → trình phát video; .mp3, .wav, .m4a, .aac, .flac → trình phát audio:

https://example.com/video/trailer.mp4
https://example.com/audio/nhacnen.mp3

9. Công thức toán (KaTeX)

Dùng $...$ cho công thức trong dòng và $$...$$ cho công thức riêng dòng:

Công lượng: $E = mc^2$

$$\int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}$$

Kết quả render:

Công thức nổi tiếng: \(E = mc^2\)

\[\sum_{k=1}^{n} k^2 = \frac{n(n+1)(2n+1)}{6}\]

10. Sơ đồ Mermaid

Vẽ lưu đồ, sơ đồ lớp, timeline, gantt, mindmap bằng block ```mermaid:

Xem thêm mọi loại sơ đồ tại tài liệu Mermaid (flowchart, sequence, class, state, ER, gantt, pie, mindmap…).

11. Chú thích cuối trang (footnote)

Louis Space viết bằng Rust[^rust] và Axum[^axum].

[^rust]: Ngôn ngữ hệ thống an toàn bộ nhớ.
[^axum]: Framework web hiệu năng cao của Rust.

Louis Space viết bằng Rust¹ và Axum². Cũng có chú thích inline kiểu ³.

12. Danh sách mô tả (description list)

Louis Space
: Nền tảng chia sẻ game & tin tức Việt Nam
Rust
: Ngôn ngữ lập trình hệ thống an toàn bộ nhớ

Louis Space

Nền tảng chia sẻ game & tin tức Việt Nam

Rust

Ngôn ngữ lập trình hệ thống an toàn bộ nhớ

13. Emoji

Gõ mã :tên: — engine tự chuyển: 🎉 🚀 ✨ 🔥 👍 😄 🎲 🏆 ⚡ ❤️

Danh sách đầy đủ: mọi shortcode chuẩn GitHub/Emoji đều dùng được.

14. Viết tắt (abbreviation)

Khai báo ở bất kỳ đâu trong bài (dòng dạng *[TỪ]: định nghĩa) — mọi lần xuất hiện nguyên từ đó được gạch chân chấm + hiện chú giải khi rê chuột:

Ví dụ: kiếm XP mỗi ngày, GLM 5.3 là AI Agent chính thức của site (rê chuột lên chữ XP và GLM xem).

15. Mục lục tự động

Đặt dòng [toc] ở bất kỳ đâu — engine chèn mục lục đầy đủ với link neo tới từng mục (mục lục đầu trang này được tạo như vậy).

16. Bảo mật — những gì KHÔNG render

Để bảo vệ người đọc, engine từ chối một số thứ (đây là chủ đích):

• HTML thô — mọi tag viết trực tiếp đều bị escape và hiển thị như text thường (chặn XSS 100%)
• Link javascript:, data:, file: — tự động vô hiệu hoá
• Ảnh chỉ chấp nhận nguồn https:// an toàn

Bạn không cần lo mã độc khi đọc bài — chỉ cần viết Markdown thuần.

Cài đặt nhanh

1. Mở ô Thử ngay ở đầu trang, dán bất kỳ cú pháp nào ở trên
2. Viết tin tức: mục Đăng tin — dùng đủ bảng, callout, ảnh, video
3. Mô tả game: mục Đăng game — code block + ảnh chụp màn hình
4. Bio hồ sơ: Chỉnh sửa hồ sơ — Markdown đầy đủ: đậm/nghiêng/link/emoji/mention/spoiler/kbd, bảng so sánh GFM (có viền + sortable), callout [!NOTE], sơ đồ ```mermaid, công thức toán, task list, footnote

Chúc bạn viết bài vui vẻ! 🚀