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