Quartz中的所有内容都应放在/content
文件夹中。Quartz主页的内容位于content/index.md
.中。如果你已经有setup Quartz,该文件夹应该已经被初始化了。此文件夹中的任何Markdown都将由Quartz处理。
建议您使用Obsidian作为编辑和维护Quartz的一种方式。它提供了一个不错的编辑器和图形界面,用于预览、编辑和链接您的本地文件和附件。
一切都安排好了吗?让我们build并在本地预览您的Quartz!
语法
由于Quartz使用Markdown文件作为编写内容的主要方式,因此它完全支持Markdown语法。默认情况下,Quartz还附带了一些语法扩展,如Github风格的Markdown(脚注、删除线、表格、任务列表)和 Obsidian风格的Markdown (callouts, wikilinks)。
此外,Quartz还允许您在名为frontmatter的笔记中指定其他元数据。
一些常见的由Quartz原生支持的frontmatter字段:
title
: 页面的标题。如果没有提供,Quartz将使用文件名作为标题。description
: 用于链接预览的说明。aliases
: 笔记的其他名称。为字符串列表。tags
: 笔记的标签。draft
: 是否发布页面。这是在Quartz中创建private pages的一种方法。date
: 表示发布日期的字符串。通常使用“YYYY-MM-DD”格式。
同步您的内容
当你的Quartz达到你满意的程度时,你可以将你的更改保存到GitHub。
首先,确保你已经已经设置了你的GitHub存储库,然后执行npx quartz sync
。
自定义
title
、 tags
、 aliases
和cssclasses
的Frontmatter解析是Frontmatter插件的一项功能,date
由CreatedModifiedDate插件处理,“description”由Description插件处理。有关自定义选项,请参阅插件页面。