Skip to content
Nuartz

Draft Filtering

2026-11-022 min read
View Markdown
On this page

nuartz automatically excludes draft and private content from the site. This is handled at the filesystem level by getAllMarkdownFiles() in packages/nuartz/src/fs.ts, in every mode including bun dev.

How to Mark Content as Draft

Set either of these frontmatter fields:

---
draft: true
---

or

---
published: false
---

String values ("true", "false") are read the same way. Either field makes getAllMarkdownFiles() skip the file, so it never reaches the starter's generated data. It will not appear in:

  • The sidebar navigation and folder or tag listings
  • The graph view and backlinks
  • Search results and popover previews
  • The RSS feed, sitemap, llms.txt, and /md/*.md

getMarkdownBySlug() still returns unpublished files (it does not filter by frontmatter); check isUnpublished(file.frontmatter) before rendering. renderMarkdown() returns empty output for them when you pass stripDrafts: true.

Path-Level Exclusion

Any path with a segment that starts with _ or . is excluded, regardless of frontmatter. isHiddenContentPath() implements the rule, and the starter applies it to attachments too:

content/_scratch.md           → always excluded
content/_private/plan.md      → always excluded
content/.trash/old.md         → always excluded

This is useful for drafts and templates you want to keep in version control but never publish.

Implementation

if (isHiddenContentPath(entry.name)) continue
// ...
const frontmatter = normalizeFrontmatter(matter(raw).data)
if (isUnpublished(frontmatter)) continue

Source