summary:

  • Zero-config transformer.
  • Honors unlisted: true frontmatter.
  • Emits HTML; preserves direct URL access.
  • Removes page from:
    • contentIndex.json
    • RSS
    • sitemap
    • graph
    • explorer
    • search
    • backlinks
    • recent notes
    • folder listings
    • tag listings

Note

Plugin management: Configuration.

Usage

frontmatter:

---
title: My Draft
unlisted: true
---

effect:

  • Hides the page from Quartz v5 plugins that respect file.data.unlisted.

Plugin effects

PluginBehavior when unlisted: true
ContentIndexRemoved from contentIndex.json, sitemap.xml, and RSS feed.
SearchRemoved from search results (via contentIndex.json).
GraphRemoved from graph nodes and edges (via contentIndex.json).
ExplorerRemoved from sidebar file tree (via contentIndex.json).
BacklinksHidden as a backlink source.
RecentNotesRemoved from recent notes list.
FolderPageRemoved from folder discovery and listings.
TagPageRemoved from tag discovery and listings.

direct_access:

  • HTML emitted.
  • Direct URL access retained.

Configuration

options:

  • None.
quartz.config.yaml
- source: github:quartz-community/unlisted-pages
  enabled: true

Interaction with EncryptedPages

mechanic:

  • EncryptedPages also sets file.data.unlisted when:
    • unlistWhenEncrypted: true
    • unlisted: true exists in frontmatter

scenarios:

  • UnlistedPages only:
    • unlisted: true hides any page.
    • Encryption independent.
  • EncryptedPages only:
    • unlisted: true hides encrypted pages only.
    • Non-encrypted pages ignore unlisted: true.
  • Both installed:
    • Recommended.
    • unlisted: true hides any page: encrypted or unencrypted.

API

api:

  • Category: Transformer
  • Function name: ExternalPlugin.UnlistedPages()
  • Source: quartz-community/unlisted-pages
  • Install: npx quartz plugin add github:quartz-community/unlisted-pages