Markdown là một cấu trúc định dạng văn bản nhẹ, biến văn bản đơn giản thành tài liệu có cấu trúc. Được tạo ra vào năm 2004 bởi John Gruber, nó hiện là định dạng tiêu chuẩn cho tài liệu, tệp README, bài đăng trên blog và giao tiếp của nhà phát triển. Hướng dẫn này giải thích Markdown là gì, tại sao mọi người sử dụng nó và làm thế nào để bắt đầu.
Markdown là gì?
Markdown là một cách để thêm định dạng vào văn bản đơn giản bằng cách sử dụng ký tự chấm điểm đơn giản. Bạn viết trong một trình soạn thảo văn bản, và Markdown được chuyển thành kết quả định dạng (HTML, PDF, v.v.) bởi một bộ xử lý.
Ví dụ:
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item twoĐịnh nghĩa như sau:
Đây là một tiêu đề
Đây là một chữ đậm Và đây là italic.
- Danh mục thứ nhất
- Bảng thứ hai của danh sách
Định dạng sống trong chính văn bản không có XML ẩn, không có định dạng nhị phân, không có mã hóa độc quyền.
Tại sao Markdown được tạo ra?
Trước Markdown, các nhà viết web phải lựa chọn: viết bằng HTML thô (ngon và dễ mắc lỗi) hoặc sử dụng trình soạn WYSIWYG tạo ra mã lộn xộn. John Gruber thiết kế Markdown để:
- Có thể đọc được như hiện tại Ngay cả khi không có rendering,
**bold**đọc rõ ràng như nhấn mạnh - Có thể viết bởi bất cứ ai Không có phần mềm đặc biệt, chỉ là một trình soạn thảo văn bản
- Chuyển đổi thành HTML định dạng đầu ra chính
Các thông số kỹ thuật ban đầu tập trung vào sản xuất HTML sạch. Nhưng Markdown từ đó đã lan rộng đến hàng chục nền tảng và định dạng đầu ra.
Markdown được sử dụng ở đâu?
Markdown ở khắp mọi nơi trong công nghệ:
| Nền tảng | Markdown làm gì |
|---|---|
| GitHub | README, vấn đề, yêu cầu kéo, wiki |
| Notion | Nội dung trang và tài liệu |
| Obsidian | Tất cả những ghi chú trong kho tàng |
| WordPress | Các bài đăng thông qua plugin Markdown |
| GitBook | Các trang tài liệu |
| Slack / Discord | Định dạng tin nhắn |
| Stack Overflow | Câu hỏi và câu trả lời |
| Jekyll / Hugo / Astro | Các bài đăng trên blog và các trang tĩnh |
| Cuốn sổ ghi chép Jupyter | Các ô tài liệu |
Nếu bạn viết bất kỳ nội dung kỹ thuật nào, bạn gần như chắc chắn đã gặp phải Markdown.
Markdown so với Word: Sự khác biệt chính
| Phương diện | Word | Markdown |
|---|---|---|
| Định dạng | Binary (.docx) | Văn bản đơn giản (.md) |
| Tính di động | Yêu cầu Word hoặc ứng dụng tương thích | Mở trong bất kỳ trình soạn thảo văn bản nào |
| Kiểm soát phiên bản | Khó (những sự khác biệt nhị phân) | Dễ dàng (phân biệt Git từng dòng) |
| Phân phối | Tích hợp với ứng dụng | Yêu cầu trình hiển thị Markdown |
| cong học tập | WYSIWYG (không học) | Yêu cầu học ngoại ngữ |
| Hỗ trợ nền tảng | Hệ sinh thái Microsoft | Công cụ phát triển phổ quát |
Nếu bạn có Word tài liệu bạn muốn chuyển đổi thành Markdown, WordToMD Không đăng ký, không tải lên.
Cơ bản Markdown Phương pháp
Dưới đây là những yếu tố phổ biến nhất:
Các tiêu đề
# Heading 1
## Heading 2
### Heading 3Xem thêm Markdown Hướng dẫn tiêu đề để tham khảo đầy đủ.
Nhấn mạnh
**Bold text**
*Italic text*
~~Strikethrough~~Danh sách
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. ThirdCác liên kết
[Link text](https://example.com)Hình ảnh
Mã số
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |Xem thêm Markdown Bảng: Hướng dẫn đầy đủ.
Nhóm hạn ngạch
> This is a blockquote.
> It can span multiple lines.Markdown hương vị
Markdown không phải là một tiêu chuẩn duy nhất có một số biến thể:
- CommonMark Một thông số kỹ thuật nghiêm ngặt và rõ ràng
- GitHub Có hương vị Markdown (GFM) CommonMark + bảng, danh sách nhiệm vụ, đánh dấu, liên kết tự động
- MultiMarkdown Thêm chú thích chân trang, trích dẫn, siêu dữ liệu
- Pandoc Markdown Loại tính năng phong phú nhất, được sử dụng bởi bộ chuyển đổi Pandoc
Hầu hết các nền tảng đều hỗ trợ ít nhất CommonMark. GitHub, Obsidian, và GitBook sử dụng GFM. Để biết thông tin đầy đủ, xem Markdown Phân âm bảng tham khảo nhanh.
Làm thế nào để viết Markdown
Bạn không cần phần mềm đặc biệt. Các lựa chọn bao gồm:
- VS Code Tự do, trình soạn thảo mạnh mẽ với built-in Markdown preview
- Obsidian Markdown ứng dụng ghi chú với biểu đồ
- Typora WYSIWYG Markdown trình soạn thảo
- iA Tác giả Môi trường viết tập trung
- Bất kỳ trình soạn thảo văn bản đơn giản nào Notepad, TextEdit, vim, emacs
Chuyển đổi giữa Markdown và các định dạng khác
Nếu bạn có Word tài liệu để chuyển đổi thành Markdown, WordToMD làm nó trong vài giây hoàn toàn miễn phí, không cần tải lên file.
Đối với ngược lại (Markdown để Word hoặc PDF), các công cụ như Pandoc xử lý chuyển đổi này. Xem thêm Pandoc Word đến Markdown cho hướng dẫn thiết lập.
FAQ
Markdown là một ngôn ngữ lập trình? Không, không. Markdown là một ngôn ngữ đánh dấu nó mô tả định dạng, không phải logic hoặc tính toán.
Tôi có thể sử dụng Markdown trong Microsoft Word không? Word không hiển thị Markdown một cách bản địa, nhưng có Word add-in bổ sung hỗ trợ Markdown. Thay vào đó, chuyển đổi Word thành Markdown với WordToMD và sử dụng trình chỉnh sửa Markdown.
Markdown có tốt cho các tài liệu dài không? Vâng, với cấu trúc hướng dẫn tốt. Tài liệu rất dài được hưởng lợi từ việc chia thành nhiều tập tin (như trong GitBook hoặc Obsidian khoang).
Markdown sử dụng file extension nào?
.md là tiêu chuẩn. .markdown cũng hợp lệ. Một số nền tảng sử dụng .mdx cho Markdown với các thành phần JSX (React).
Kết luận
Markdown là một định dạng đơn giản, mạnh mẽ đã trở thành ngôn ngữ giao tiếp của văn bản kỹ thuật. Nó có thể đọc được như văn bản đơn giản, trình bày đẹp và hoạt động với mọi công cụ phát triển chính. Nếu bạn là người mới, hãy bắt đầu với Markdown Phân âm bảng tham khảo nhanh và cố gắng chuyển đổi tài liệu Word đầu tiên của bạn tại WordToMD.