Cú pháp cơ bản Markdown
Markdown là một ngôn ngữ đánh dấu nhẹ với cú pháp định dạng đơn giản, cho phép mọi người tập trung vào nội dung hơn là định dạng. Nó sử dụng định dạng văn bản thuần túy dễ đọc và dễ viết để viết tài liệu, có thể trộn với HTML, và có thể xuất sang tệp HTML, PDF và định dạng .md chính nó.
Triết lý thiết kế
Mục tiêu của Markdown là đạt được "dễ đọc, dễ viết".
Tính khả đọc, bất kể như thế nào, là điều quan trọng nhất. Một tệp được viết bằng định dạng Markdown nên có thể được xuất bản trực tiếp dưới dạng văn bản thuần túy, và không có vẻ như được tạo ra từ nhiều thẻ hoặc lệnh định dạng.
Mục tiêu thiết kế chính của cú pháp Markdown là dễ đọc nhất có thể. Dựa trên mục tiêu này, tài liệu định dạng Markdown có thể được xuất bản ở dạng văn bản thuần túy nguyên bản, mà không có vẻ như bị lấp đầy bởi các thẻ hoặc lệnh định dạng.
—— John Gruber
Tương thích HTML
Mục tiêu của cú pháp Markdown là: trở thành ngôn ngữ viết phù hợp với web.
Markdown không muốn thay thế HTML, thậm chí cũng không muốn gần gũi với nó, các loại cú pháp rất ít, chỉ tương ứng với một phần nhỏ của HTML tags.
Các thẻ không nằm trong phạm vi mà Markdown bao phủ có thể được viết trực tiếp trong tài liệu bằng HTML. Không cần ghi chú thêm rằng đây là HTML hay Markdown; chỉ cần thêm thẻ trực tiếp.
Ví dụ: thêm bảng HTML trong tệp Markdown:
Đây là một đoạn văn bình thường.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
Đây là một đoạn văn khác.Chuyển đổi ký tự đặc biệt tự động
Trong tệp HTML, có hai ký tự cần xử lý đặc biệt: < và &.
- Ký tự
<được sử dụng cho thẻ bắt đầu - Ký tự
&được sử dụng để đánh dấu HTML entities
Markdown cho phép bạn viết các ký tự một cách tự nhiên, việc chuyển đổi sẽ được xử lý bởi nó. Nếu ký tự & bạn sử dụng là một phần của HTML character entity, nó sẽ giữ nguyên, nếu không nó sẽ được chuyển đổi thành &.
Các phần tử cú pháp cơ bản
Cú pháp cơ bản Markdown bao gồm các phần tử sau:
Phần tử cấp khối
- Tiêu đề - Sử dụng
#để tạo các tiêu đề cấp khác nhau - Đoạn văn và ngắt dòng - Quy tắc đoạn văn và ngắt dòng
- Trích dẫn - Sử dụng
>để tạo khối trích dẫn - Danh sách - Danh sách có thứ tự và không có thứ tự
- Khối mã - Định dạng đặc biệt để hiển thị mã
- Đường phân cách - Tạo đường phân cách ngang
Phần tử nội tuyến
- Nhấn mạnh - Văn bản đậm và nghiêng
- Liên kết - Tạo siêu liên kết
- Hình ảnh - Chèn hình ảnh
- Mã nội tuyến - Đánh dấu mã nội tuyến
Khác
- Ký tự thoát - Thoát ký tự đặc biệt
- Liên kết tự động - Nhận dạng liên kết tự động
Ví dụ cú pháp
Dưới đây là một ví dụ bao gồm nhiều cú pháp cơ bản:
# Tài liệu của tôi
Đây là một ví dụ về**văn bản đậm**và*văn bản nghiêng*
## Ví dụ danh sách
### Danh sách mua sắm
- Táo
- Chuối
- Cam
### Danh sách công việc
1. Học cú pháp cơ bản Markdown
2. Thực hành viết
3. Chia sẻ với bạn bè
> Đây là một ví dụ về khối trích dẫn. Markdown làm cho việc viết trở nên đơn giản và thanh lịch.
Đây là một ví dụ về[liên kết đến trang chủ](/vi/)
Ví dụ mã:Bạn cũng có thể sử dụng mã nội tuyến, chẳng hạn như console.log('Hello World').
Thực hành tốt nhất
Sử dụng tiêu đề
- Chỉ sử dụng một tiêu đề cấp 1 (
#) cho mỗi tài liệu - Duy trì logic cấp độ tiêu đề, không nhảy cấp
- Để trống dòng trước và sau tiêu đề
Định dạng danh sách
- Danh sách không có thứ tự giữ tính nhất quán của ký hiệu (sử dụng thống nhất
-,*hoặc+) - Không cần dòng trống giữa các mục danh sách, trừ khi có nhiều đoạn văn
Liên kết và hình ảnh
- Cung cấp mô tả văn bản có ý nghĩa cho liên kết
- Cung cấp văn bản thay thế (alt text) cho hình ảnh
Hiển thị mã
- Sử dụng định dạng mã nội tuyến cho mã ngắn
- Sử dụng khối mã cho mã dài hoặc mã nhiều dòng
- Chỉ định ngôn ngữ cho khối mã để có tô sáng cú pháp
Hỗ trợ công cụ
Hầu như tất cả các ứng dụng Markdown đều hỗ trợ các phần tử cú pháp cơ bản này. Có thể có sự khác biệt nhỏ giữa các bộ xử lý Markdown khác nhau, nhưng cú pháp cơ bản là phổ biến.
Bước tiếp theo
Bây giờ bạn đã hiểu tổng quan về cú pháp cơ bản Markdown, bạn có thể:
- Tìm hiểu sâu về cách sử dụng của từng phần tử cú pháp
- Xem bảng tham khảo cú pháp để tham khảo nhanh
- Học cú pháp mở rộng để có thêm tính năng
- Khám phá cách sử dụng nâng cao và thực hành tốt nhất
Bắt đầu học các phần tử cú pháp cụ thể: