Gạch xoá
Gạch xoá là cú pháp mở rộng của Markdown, dùng để biểu thị đoạn văn bản đã bị xoá hoặc không còn hiệu lực. Nó rất hữu ích trong các ngữ cảnh như chỉnh sửa tài liệu, danh sách công việc và thay đổi giá.
Cú pháp cơ bản
Cú pháp chuẩn
Trong Markdown, gạch xoá thường sử dụng hai dấu ngã (~~) bao quanh phần văn bản cần gạch xoá:
Đây là một đoạn ví dụ có chứa ~~văn bản gạch xoá~~.Hiệu ứng hiển thị:
Đây là một đoạn ví dụ có chứa văn bản gạch xoá.
Cụm từ và câu
Gạch xoá có thể áp dụng cho một từ đơn lẻ hoặc cả câu:
~~Cả câu này đều bị gạch xoá.~~
Chúng ta sẽ họp vào ~~thứ Hai~~ thứ Ba tuần sau.Hiệu ứng hiển thị:
Cả câu này đều bị gạch xoá.
Chúng ta sẽ họp vào thứ Hai thứ Ba tuần sau.
Cách dùng nâng cao
Kết hợp với định dạng khác
Gạch xoá có thể kết hợp với các định dạng Markdown khác:
~~**Gạch xoá đậm**~~
~~*Gạch xoá nghiêng*~~
~~***Gạch xoá đậm nghiêng***~~
~~`Gạch xoá trong code`~~
~~[Gạch xoá trong liên kết](https://www.markdownlang.com)~~Hiệu ứng hiển thị:
Gạch xoá đậm
Gạch xoá nghiêng
Gạch xoá đậm nghiêng
Gạch xoá trong code
Đoạn văn và phần tử khối
Trong một số trình Markdown, gạch xoá có thể áp dụng cho cả một đoạn văn hoặc phần tử khối:
~~
Đây là một đoạn văn bị gạch xoá toàn bộ.
Nó có thể chứa nhiều dòng nội dung.
~~Lưu ý: Không phải mọi bộ xử lý Markdown đều hỗ trợ gạch xoá qua nhiều dòng. Với nội dung nhiều dòng, an toàn nhất là áp dụng cú pháp gạch xoá riêng cho từng dòng.
Tương thích và khác biệt triển khai
Hỗ trợ trên các nền tảng
| Nền tảng/Công cụ | Hỗ trợ gạch xoá | Cú pháp |
|---|---|---|
| GitHub Markdown | ✅ | ~~strikethrough~~ |
| GitLab Markdown | ✅ | ~~strikethrough~~ |
| Stack Overflow | ✅ | ~~strikethrough~~ |
| Discord | ✅ | ~~strikethrough~~ |
| ✅ | ~~strikethrough~~ | |
| CommonMark | ✅ | ~~strikethrough~~ |
| VitePress | ✅ | ~~strikethrough~~ |
| Pandoc | ✅ | ~~strikethrough~~ |
Đầu ra HTML
Phần lớn bộ xử lý Markdown sẽ chuyển gạch xoá thành thẻ HTML <del> hoặc <s>:
<!-- Dùng thẻ <del> -->
<p>Đây là một ví dụ có <del>văn bản gạch xoá</del>.</p>
<!-- Hoặc dùng thẻ <s> -->
<p>Đây là một ví dụ có <s>văn bản gạch xoá</s>.</p>Cú pháp thay thế
Một số nền tảng hoặc phiên bản cũ của Markdown có thể hỗ trợ cú pháp khác cho gạch xoá:
<!-- Một dấu ngã (một số nền tảng) -->
~văn bản gạch xoá~
<!-- Thẻ HTML (mọi trình Markdown tiêu chuẩn) -->
<del>văn bản gạch xoá</del>
<s>văn bản gạch xoá</s>Tình huống sử dụng
Chỉnh sửa tài liệu
Gạch xoá thường dùng để hiển thị các chỉnh sửa và thay đổi trong tài liệu:
# Kế hoạch dự án v2.0
## Lịch trình
- Phân tích yêu cầu: ~~1/3–15/3~~ 1/3–20/3 (trì hoãn)
- Giai đoạn thiết kế: ~~16/3–5/4~~ 21/3–10/4
- Giai đoạn phát triển: 11/4–15/5
- Giai đoạn kiểm thử: 16/5–30/5
- Ngày phát hành: ~~1/6~~ 15/6Hiệu ứng hiển thị:
Kế hoạch dự án v2.0
Lịch trình
- Phân tích yêu cầu:
1/3–15/31/3–20/3 (trì hoãn) - Giai đoạn thiết kế:
16/3–5/421/3–10/4 - Giai đoạn phát triển: 11/4–15/5
- Giai đoạn kiểm thử: 16/5–30/5
- Ngày phát hành:
1/615/6
Danh sách công việc
Kết hợp gạch xoá với hộp kiểm có thể tạo danh sách công việc trực quan hơn:
## Nhiệm vụ tuần này
- [x] ~~Hoàn thành đề xuất dự án~~
- [x] ~~Gặp khách hàng để thảo luận yêu cầu~~
- [ ] Tạo nguyên mẫu thiết kế
- [ ] Viết tài liệu thông số kỹ thuật
- [ ] Chuẩn bị ước tính ngân sáchHiệu ứng hiển thị:
Nhiệm vụ tuần này
- [x]
Hoàn thành đề xuất dự án - [x]
Gặp khách hàng để thảo luận yêu cầu - [ ] Tạo nguyên mẫu thiết kế
- [ ] Viết tài liệu thông số kỹ thuật
- [ ] Chuẩn bị ước tính ngân sách
Giá và khuyến mãi
Gạch xoá rất hữu ích trong nội dung thương mại điện tử và khuyến mãi:
## Hàng khuyến mãi
- Laptop hiệu năng cao: ~~¥8,999~~ ¥7,499
- Tai nghe không dây: ~~¥1,299~~ ¥999
- Đồng hồ thông minh: ~~¥2,499~~ ¥1,999
*Hạn chót khuyến mãi: 31/12/2023*Hiệu ứng hiển thị:
Hàng khuyến mãi
- Laptop hiệu năng cao:
¥8,999¥7,499 - Tai nghe không dây:
¥1,299¥999 - Đồng hồ thông minh:
¥2,499¥1,999
Hạn chót khuyến mãi: 31/12/2023
Hài hước và nhấn mạnh
Đôi khi gạch xoá được dùng để thể hiện tính hài hước hoặc nhấn mạnh:
Cuộc họp hôm nay ~~rất nhàm chán~~ rất hiệu quả.
Tôi ~~ghét~~ thích viết tài liệu.
Dự án này ~~có thể thất bại~~ chắc chắn sẽ thành công!Hiệu ứng hiển thị:
Cuộc họp hôm nay rất nhàm chán rất hiệu quả.
Tôi ghét thích viết tài liệu.
Dự án này có thể thất bại chắc chắn sẽ thành công!
Thực tiễn tốt
Gợi ý sử dụng
✅ Nên làm:
1. **Diễn đạt rõ ràng thay đổi**:
- Xoá nội dung cũ, thêm nội dung mới
- Ví dụ: ~~phiên bản sai~~ phiên bản đúng
2. **Sử dụng ngắn gọn**:
- Tránh quá nhiều nội dung gạch xoá gây khó đọc
- Cân nhắc có thực sự cần giữ lại nội dung cũ không
3. **Kết hợp với đánh dấu khác**:
- Kết hợp hộp kiểm trong danh sách công việc
- Kết hợp định dạng khác để tăng biểu đạt
❌ Tránh làm:
1. Dùng quá nhiều định dạng phức tạp trong phần gạch xoá
2. Gạch xoá cả đoạn dài (ảnh hưởng khả năng đọc)
3. Lạm dụng gạch xoá mang tính hài hước trong tài liệu quan trọng
4. Áp dụng gạch xoá cho cả văn bản dài hoặc nhiều đoạnKhả năng truy cập (a11y)
Gạch xoá có thể gây nhầm lẫn cho người dùng trình đọc màn hình. Cân nhắc các điểm sau:
- Thêm ngữ cảnh giải thích cho nội dung gạch xoá
- Cân nhắc cách khác (như ngoặc, chú thích) để biểu thị nội dung bỏ đi
- Nếu nội dung không còn liên quan, cân nhắc xoá hẳn thay vì gạch xoá
<!-- Cách viết dễ tiếp cận hơn -->
Hạn chót dự án: 15/3 (đã cập nhật: kế hoạch cũ 1/3)
<!-- Thay vì -->
Hạn chót dự án: ~~1/3~~ 15/3Khắc phục sự cố
Gạch xoá không hiển thị
Nếu gạch xoá không hiển thị đúng:
- Đảm bảo dùng hai dấu ngã
~~, không phải một~ - Kiểm tra có khoảng trắng giữa dấu ngã và văn bản không (không nên có)
- Xác nhận trình Markdown của bạn có hỗ trợ cú pháp gạch xoá
- Thử dùng thẻ HTML
<del>như một phương án thay thế
Vấn đề với định dạng phức tạp
Có thể phát sinh vấn đề khi gạch xoá kết hợp với định dạng khác:
<!-- Cách viết có thể gây lỗi -->
~~**[Định dạng phức tạp](https://www.markdownlang.com)**~~
<!-- Cách an toàn hơn -->
<del>**[Định dạng phức tạp](https://www.markdownlang.com)**</del>Gạch xoá nhiều đoạn
Với trường hợp cần gạch xoá qua nhiều đoạn, nên dùng HTML:
<del>
Đây là đoạn đầu tiên bị gạch xoá.
Đây là đoạn thứ hai bị gạch xoá.
</del>Cú pháp liên quan
- Danh sách công việc - Tạo danh sách có hộp kiểm
- Nhấn mạnh - Cú pháp nhấn mạnh (đậm, nghiêng)
- HTML - Sử dụng HTML trong Markdown
Tổng kết
Gạch xoá là một cú pháp mở rộng đơn giản nhưng mạnh mẽ trong Markdown. Nó cung cấp cách trực quan để biểu thị nội dung đã chỉnh sửa, công việc đã hoàn thành hoặc thông tin lỗi thời. Sử dụng hợp lý gạch xoá sẽ giúp tài liệu rõ ràng, sinh động hơn và giúp người đọc dễ theo dõi quá trình thay đổi nội dung.