Biên soạn nội dung

Tất cả nội dung trong Quartz của bạn phải nằm trong  /content thư mục. Nội dung cho trang chủ của Quartz nằm trong content/index.md. Nếu bạn đã thiết lập Quartz , thư mục này sẽ được khởi tạo. Bất kỳ Markdown nào trong thư mục này sẽ được Quartz xử lý.

Bạn nên sử dụng Obsidian để chỉnh sửa và bảo trì Quartz của mình. Nó đi kèm với trình chỉnh sửa đẹp mắt và giao diện đồ họa để xem trước, chỉnh sửa và liên kết các tệp và tệp đính kèm cục bộ của bạn.

Bạn đã thiết lập xong mọi thứ chưa? Hãy cùng xây dựng và xem trước Quartz của bạn tại địa phương!

Cú pháp

Vì Quartz sử dụng tệp Markdown làm cách chính để viết nội dung nên nó hỗ trợ đầy đủ cú pháp Markdown. Theo mặc định, Quartz cũng cung cấp một số tiện ích mở rộng cú pháp như Github Flavored Markdown (chú thích, gạch ngang, bảng, danh sách tác vụ) và Obsidian Flavored Markdown ( chú thích , liên kết wiki ).

Ngoài ra, Quartz còn cho phép bạn chỉ định siêu dữ liệu bổ sung trong ghi chú của mình, được gọi là frontmatter .

nội dung/lưu ý.md

<span data-line=""><span>---</span></span>
<span data-line=""><span>title: Example Title</span></span>
<span data-line=""><span>draft: false</span></span>
<span data-line=""><span>tags:</span></span>
<span data-line=""><span>  -</span><span> example-tag</span></span>
<span data-line=""><span>---</span></span>
<span data-line=""> </span>
<span data-line=""><span>The rest of your content lives here. You can use </span><span>**Markdown**</span><span> here :)</span></span>

Một số trường nội dung chính phổ biến được Quartz hỗ trợ:

• title: Tiêu đề của trang. Nếu không cung cấp, Quartz sẽ sử dụng tên tệp làm tiêu đề.
• description:Mô tả trang được sử dụng để xem trước liên kết.
• permalink: URL tùy chỉnh cho trang sẽ không đổi ngay cả khi đường dẫn đến tệp thay đổi.
• aliases: Tên gọi khác của ghi chú này. Đây là danh sách các chuỗi.
• tags: Thẻ cho ghi chú này.
• draft: Có nên xuất bản trang hay không. Đây là một cách để làm cho các trang trở nên riêng tư trong Quartz.
• date: Một chuỗi biểu thị ngày ghi chú được xuất bản. Thông thường sử dụng YYYY-MM-DDđịnh dạng.

Đồng bộ hóa nội dung của bạn

Khi Quartz của bạn đạt đến điểm mà bạn hài lòng, bạn có thể lưu các thay đổi của mình vào GitHub. Trước tiên, hãy đảm bảo rằng bạn đã thiết lập kho lưu trữ GitHub của mình và sau đó thực hiện npx quartz sync.

Tùy chỉnh

Phân tích Frontmatter cho title, tags, aliasesvà cssclasseslà chức năng của plugin Frontmatter , dateđược xử lý bởi plugin CreatedModifiedDate và descriptionplugin Description . Xem các trang plugin để biết các tùy chọn tùy chỉnh.

---