In và dùng tệp Markdown¶
Tổng quan hướng dẫn
Trước khi bắt đầu¶
Bạn cần |
Lý do |
|---|---|
Vai trò Người xem trở lên trong Không gian |
Để in một trang hoặc xuất ra Markdown. |
Vai trò Biên tập viên hoặc Quản trị không gian trong Không gian |
Để tạo trang từ một tệp Markdown. |
In một trang¶
Mở trang và nhấp nút bánh răng cạnh tiêu đề. Trên điện thoại, các thao tác này cũng nằm trong menu bánh răng.
Chọn In. Trình duyệt tải về một tệp PDF.
PDF bắt đầu bằng tiêu đề và vài dòng thông tin về trang, rồi hiển thị nội dung như người đọc thấy:
Không gian - Không gian chứa trang.
Người phụ trách - người phụ trách trang.
Sửa lần cuối và Sửa lần cuối bởi - ngày sửa gần nhất và người sửa.
Xác minh lần cuối - ngày xác minh gần nhất, hoặc "Không bao giờ", và Người xác minh khi trang đã được xác minh.
Các nhãn theo ngôn ngữ của người in.
Xuất một trang ra Markdown¶
Mở trang, nhấp nút bánh răng và chọn Xuất dạng Markdown.
Trình duyệt tải về một tệp văn bản đặt theo tên trang, ví dụ
Travel booking steps.md. Một thông báo xác nhận đã tải.
Mở tệp bằng bất kỳ trình soạn thảo văn bản nào, hoặc dán vào công cụ khác đọc được Markdown. Với trang trong ảnh chụp của hướng dẫn này, tệp có nội dung như sau:
# Travel booking steps
Book travel **before** the trip starts, and keep the *receipt* of every ticket.
## Before you book
- [x] Approval received from the manager
- [ ] Receipt attached to the claim
## Limits
| Trip | Limit |
| --- | --- |
| Domestic | 200 |
| International | 800 |
> Ask the travel agency for the invoice.
Tệp chứa nội dung như bạn đọc. Liên kết hoặc khối nhúng chỉ trỏ tới và nêu tên những gì bạn được đọc. Khối nhúng không viết ra được sẽ ghi "Nội dung nhúng (mở trang để xem)".
Tạo trang từ tệp Markdown¶
Nhấp Trang mới ở thanh bên, hoặc ở Trang chủ.
Trong Trong không gian, chọn Không gian. Hộp thoại bắt đầu với Không gian bạn đang ở.
Nhấp Nhập Markdown và chọn tệp
.md.
Trang được tạo và mở trong trình soạn thảo, trong Không gian bạn đã chọn. Tiêu đề của trang là đề mục đầu tiên của văn bản. Khi tệp không có đề mục, tiêu đề là tên tệp không kèm phần mở rộng.
Trong Không gian yêu cầu rà soát mọi thay đổi, trang mới là dự thảo cho đến khi được duyệt (xem Gửi và duyệt thay đổi của trang).
Phần được giữ¶
Xuất và nhập dùng cùng một tập Markdown, nên trang viết bằng các thành phần này quay lại nguyên vẹn:
Thành phần |
Được giữ dưới dạng |
|---|---|
Tiêu đề |
Cấp 1 đến 3. |
Văn bản |
Đoạn văn có chữ đậm, chữ nghiêng, mã nội dòng, liên kết và hình ảnh. |
Danh sách |
Danh sách gạch đầu dòng, đánh số và danh sách kiểm, kể cả danh sách lồng nhau, với ô đã đánh dấu. |
Trích dẫn và mã |
Trích dẫn và khối mã có ngôn ngữ của chúng. |
Bảng và đường kẻ |
Bảng và đường kẻ ngang. |
Phần còn lại được ghi thành một đoạn văn gồm chữ của nó, nên không mất chữ nào.
Tiêu đề đầu tiên của tệp nhập vẫn nằm trong nội dung trang, bên cạnh việc là tên trang. Một tệp chứa tối đa 1.000.000 ký tự.
Điểm kiểm tra thành công¶
In tải về một PDF có tiêu đề, Không gian, người phụ trách và lần xác minh cuối.
Xuất dạng Markdown tải về tệp
.mdmở được bằng trình soạn thảo văn bản.Nhập Markdown tạo một trang đặt tên theo tiêu đề đầu tiên của tệp, trong Không gian bạn đã chọn.
Các vấn đề thường gặp¶
Vấn đề |
Cách xử lý |
|---|---|
Không gian tôi cần không có trong Trong không gian. |
Danh sách chỉ hiện các Không gian mà bạn là Biên tập viên hoặc Quản trị không gian. Hãy nhờ quản trị không gian cấp vai trò. |
Việc nhập báo tệp quá dài. |
Một tệp Markdown chứa tối đa 1.000.000 ký tự. Hãy tách thành nhiều tệp. |
Việc nhập báo tệp không phải tệp văn bản. |
Hãy chọn một tệp |
Một liên kết trong tệp xuất bị thiếu. |
Trang liên kết tới thứ bạn không được đọc. Tệp chỉ nêu tên và liên kết những gì bạn được đọc. |
Trang in ra không có dòng Người xác minh. |
Trang chưa từng được xác minh (xem Sở hữu và xác minh trang). |
Bước tiếp theo¶
Đọc, tạo và sửa trang - tạo và sửa trang bằng trình soạn thảo.
Chia sẻ trang với người trong và ngoài công ty - chia sẻ trang bằng liên kết thay vì tệp.