Quartz creates listing pages for any folders and tags you have.

Folder Listings

Quartz will generate an index page for all the pages under that folder. This includes any content that is multiple levels deep.

Additionally, Quartz will also generate pages for subfolders. Say you have a note in a nested folder content/abc/def/note.md. Then, Quartz would generate a page for all the notes under abc and a page for all the notes under abc/def.

By default, Quartz will title the page Folder: <name of folder> and no description. You can override this by creating an index.md file in the folder with the title frontmatter field. Any content you write in this file will also be used in the description of the folder.

For example, for the folder content/posts, you can add another file content/posts/index.md to add a specific description for it.

Tag Listings

Quartz will also create an index page for each unique tag in your vault and render a list of all notes with that tag.

Quartz also supports tag hierarchies as well (e.g. plugin/emitter) and will also render a separate tag page for each layer of the tag hierarchy. It will also create a default global tag index page at /tags that displays a list of all the tags in your Quartz.

Like folder listings, you can also provide a description and title for a tag page by creating a file for each tag. For example, if you wanted to create a custom description for the#component tag, you would create a file at content/tags/component.md with a title and description.

Customization

The layout for both the folder and content pages can be customized. By default, they use the defaultListPageLayout in quartz.layouts.ts. If you’d like to make more involved changes to the layout and don’t mind editing some Quartz components, you can take a look at quartz/components/pages/FolderContent.tsx and quartz/components/pages/TagContent.tsx respectively.

  • Removing folder listings: remove Plugin.FolderPage() from emitters in quartz.config.ts
  • Removing tag listings: remove Plugin.TagPage() from emitters in quartz.config.ts