private_pages:

  • purpose: prevent notes from publishing
  • mechanisms:
    • filter_plugins:
      • source: Filter plugins
      • behavior: exclude content by criteria
      • plugins:
        • RemoveDrafts: default; excludes notes with draft: true in frontmatter
        • ExplicitPublish: excludes all notes except notes with publish: true in frontmatter
      • warning:

        Warning

        Filter plugins do not block non-Markdown assets: Quartz emits all non-Markdown files (images, audio, PDFs, etc.) into the final build, making them public.

    • ignorePatterns:
      • location: quartz.config.yaml → main configuration
      • behavior: excludes matching paths from parsing
      • syntax: fast-glob, not standard Bash glob syntax
      • examples:
        • some/folder: excludes entire folder
        • *.md: excludes all .md files
        • !(*.md): excludes all non-.md files; negations require parentheses
        • **/private: excludes files/folders named private at any nesting level
      • warning:

        ignorePatterns only remove files from the built site. A public GitHub repository still exposes source files unless matching patterns exist in .gitignore. See git documentation.

        Plugins and