Xuống dòng trong Markdown: dòng mới, đoạn văn và ô bảng
Tạo dòng mới trong Markdown bằng dấu gạch chéo ngược, hai dấu cách hoặc dòng trống. Sửa cách xuống dòng trong README, danh sách và ô bảng trước khi xuất sang Word.
Để bắt đầu một dòng mới bên trong đoạn văn Markdown, hãy đặt dấu gạch chéo ngược ở cuối dòng đầu tiên rồi nhấn Enter. Để bắt đầu một đoạn văn riêng, hãy chừa một dòng trống. Hai cách này tạo ra cấu trúc tài liệu khác nhau, điều cần lưu ý khi sau này bạn xuất README, địa chỉ hoặc báo cáo sang Word.
Nhóm tài liệu\
42 Đường Ví Dụ\
Portland, Oregon
Địa chỉ vẫn nằm trong một đoạn văn nhưng được hiển thị trên ba dòng. Dán vào bản xem trước Markdown để so sánh với các ví dụ bên dưới.
Chọn kiểu ngắt phù hợp
| Kết quả mong muốn | Mã nguồn Markdown | Trường hợp thường dùng |
|---|---|---|
| Tiếp tục cùng một đoạn văn | Một lần xuống dòng thông thường | Chia các dòng mã nguồn dài |
| Bắt đầu dòng khác trong cùng đoạn văn | Dấu gạch chéo ngược rồi nhấn Enter | Địa chỉ và thơ ngắn |
| Bắt đầu đoạn văn mới | Một dòng trống | Tách các ý trong bài viết |
| Xuống dòng trong ô bảng | <br> khi có hỗ trợ HTML | Hai nhãn ngắn trong một ô |
Xuống dòng không tạo ra ngắt trang. Nếu phần tiếp theo cần bắt đầu trên trang mới trong tài liệu xuất ra, hãy xem hướng dẫn ngắt trang Markdown riêng.
Vì sao nhấn Enter có thể trông như một dấu cách
Hãy thử mã nguồn này:
Bản nháp đã sẵn sàng.
Người duyệt có thể mở tài liệu hôm nay.
Trong bản xem trước của trang này, cả hai câu thuộc cùng một đoạn văn và được trình bày liền nhau. Ký tự xuống dòng vẫn hữu ích trong tệp nguồn nhưng không buộc trình duyệt bắt đầu một dòng hiển thị mới. Trình duyệt vẫn có thể tự ngắt dòng theo chiều rộng có sẵn.
Bây giờ hãy chèn một dòng trống:
Bản nháp đã sẵn sàng.
Người duyệt có thể mở tài liệu hôm nay.
Bản xem trước tạo ra hai đoạn văn. Hãy dùng cách này khi câu thứ hai bắt đầu một ý mới. Thêm nhiều dòng trống không phải là cách đáng tin cậy để tăng khoảng cách theo chiều dọc; kiểu trình bày đoạn văn do bộ kết xuất hoặc mẫu tài liệu quyết định.
Dấu gạch chéo ngược hoặc hai dấu cách cuối dòng
CommonMark định nghĩa hai dấu cách trước ký tự xuống dòng và một dấu gạch chéo ngược trước ký tự xuống dòng là cú pháp ngắt dòng bắt buộc bên trong đoạn văn. Các ví dụ ngắt dòng bắt buộc của CommonMark mô tả cả hai dạng.
Dạng dùng dấu gạch chéo ngược có thể nhìn thấy khi duyệt tệp:
Do nhóm tài liệu biên soạn\
Do người quản lý phát hành duyệt
Cách còn lại là nhập đúng hai dấu cách sau soạn, rồi nhấn Enter. Những dấu cách này không hiển thị trong nhiều trình soạn thảo và có thể bị chức năng tự động dọn khoảng trắng cuối dòng xóa đi. Nếu ngắt dòng biến mất sau khi lưu, hãy kiểm tra thiết lập khoảng trắng hoặc dùng dạng dấu gạch chéo ngược.
Đừng nhập hai ký tự \n vào văn bản thông thường rồi mong đợi một dòng mới. Đó là quy ước của chuỗi trong lập trình, không phải cách xuống dòng Markdown. Cũng tránh đặt dấu gạch chéo ngược ở tận cuối đoạn văn: sau ngắt dòng bắt buộc phải còn một dòng nội dung khác thuộc đoạn văn đó.
Bình luận GitHub và tệp README hoạt động khác nhau
Tài liệu về xuống dòng của GitHub phân biệt tệp .md trong kho mã với vấn đề, yêu cầu kéo và thảo luận. Các ký tự xuống dòng thông thường có thể được hiển thị thành ngắt dòng ở những giao diện trao đổi đó, trong khi README cần cú pháp ngắt dòng bắt buộc rõ ràng.
Sự khác biệt này giải thích vì sao văn bản sao chép từ một vấn đề có thể trông khác trong README. Hãy kiểm tra tệp đích thay vì cho rằng mọi giao diện trên cùng một trang web đều dùng quy tắc định dạng giống hệt nhau.
Giữ dòng tiếp theo bên trong mục danh sách
Thụt dòng tiếp theo để căn với vị trí bắt đầu văn bản của mục:
- Ghi chú phát hành\
Bao gồm hướng dẫn di chuyển.
- Hướng dẫn cài đặt
Ở đây, mục đầu tiên gồm hai dòng hiển thị. Mục thứ hai vẫn tách biệt. Để tạo một đoạn văn riêng bên trong mục đầu tiên, hãy dùng dòng trống và giữ phần tiếp theo được thụt lề:
- Ghi chú phát hành
Bao gồm hướng dẫn di chuyển và các vấn đề đã biết.
- Hướng dẫn cài đặt
Hướng dẫn thụt lề trình bày danh sách đánh số, danh sách dấu đầu dòng lồng nhau và mã bên trong một mục.
Thêm dòng mới trong ô bảng Markdown
Một hàng bảng GFM phải nằm trên một dòng mã nguồn. Nhấn Enter trong nội dung có thể làm tách hàng. Với bộ kết xuất cho phép ngắt dòng HTML, hãy dùng mẫu sau:
| Tài liệu | Người phụ trách |
| --- | --- |
| Ghi chú phát hành | Người viết<br>Người duyệt |
Bản xem trước của trang này hỗ trợ ví dụ trên. Một nơi xuất bản loại bỏ HTML có thể xóa ngắt dòng hoặc hiển thị nguyên thẻ, vì vậy hãy kiểm tra nền tảng đó trước khi áp dụng cho toàn bộ tài liệu. Danh sách đặt ngoài bảng thường dễ bảo trì hơn khi một ô cần chứa nhiều đoạn văn.
Dùng trình tạo bảng Markdown cho dữ liệu dạng bảng và hướng dẫn cú pháp bảng để tìm hiểu căn lề và thoát ký tự gạch đứng.
Kiểm tra tài liệu đã xuất
Trước khi dùng trình chuyển đổi Markdown sang Word, hãy thử một mẫu ngắn chứa một lần xuống dòng thông thường, một ngắt dòng bắt buộc rõ ràng và một dòng trống. Bản xem trước tương ứng phải hiển thị một đoạn văn liền mạch, một ngắt dòng bắt buộc và hai đoạn văn riêng biệt.
Mở DOCX đã tải xuống rồi kiểm tra địa chỉ, danh sách và bảng. Chiều rộng trang và kiểu đoạn văn của Word có thể làm thay đổi vị trí tự ngắt dòng ngay cả khi các ngắt dòng trong cấu trúc đã đúng. Hãy sửa cấu trúc Markdown trước; điều chỉnh cách trình bày chữ cuối cùng trong Word khi một mẫu tài liệu cụ thể yêu cầu.