Skip to content

Instantly share code, notes, and snippets.

@jarp0l
Created July 29, 2025 14:53
Show Gist options
  • Select an option

  • Save jarp0l/4c92abf768392073aa87ab67c29a0186 to your computer and use it in GitHub Desktop.

Select an option

Save jarp0l/4c92abf768392073aa87ab67c29a0186 to your computer and use it in GitHub Desktop.

🧠 Quartz Cheatsheet: Notes vs Posts

A reference for when to use Notes or Posts in your Quartz site (e.g. Obsidian + Quartz).


πŸ“Š Notes vs Posts Summary Table

Feature πŸ“’ Notes πŸ“° Posts
Purpose Evergreen knowledge, concept capture Personal thoughts, updates, reflections
Tone Informative, concise, factual Narrative, expressive, subjective
Audience Mostly yourself or future reference Readers or public consumption
Structure Evolving, interlinked Static, time-stamped
Typical Content Definitions, how-tos, research, ideas Blog posts, stories, essays, reflections
Frontmatter title, tags title, date, tags
Examples Digital Garden, Markdown Syntax, Zettelkasten Why I Moved to Quartz, July Notes
Update Frequency Frequent, iterative Rare, mostly published once
Linking Style Heavy internal linking ([[Note Title]]) May link to Notes, fewer inbound links
Best For Knowledge base, digital garden Blog, journal, announcement feed

πŸ“’ NOTES β€” Evergreen, Interlinked Knowledge

Purpose:

  • Capture and evolve ideas over time
  • Serve as a personal or public knowledge base
  • Encourage linking and networked thinking

Tone:

  • Informative, factual, idea-focused
  • Iterative and revisitable

Content Types:

  • Definitions
  • Concept explanations
  • How-tos
  • Research summaries
  • Book/article notes
  • Personal insights with links

Examples:

  • Zettelkasten Method
  • Why I Like Markdown
  • Note-taking Tools Comparison
  • Digital Minimalism
  • [[Writing Process]] β†’ links to [[Brainstorming]], [[Editing]], etc.

Structure Tips:

  • Use [[WikiLinks]] to connect ideas
  • Keep atomic: one idea per note
  • Use tags for grouping (in frontmatter or Obsidian-style)

πŸ“° POSTS β€” Chronological, Narrative Entries

Purpose:

  • Share thoughts, opinions, experiences
  • Tell stories or document progress
  • Publish essays, reflections, updates

Tone:

  • Personal, expressive, complete
  • Static once published (though can update if needed)

Content Types:

  • Blog posts
  • Announcements
  • Project updates
  • Personal stories
  • Monthly reflections
  • Essays

Examples:

  • Why I Moved from Ghost to Quartz
  • My Writing System in 2025
  • July Reflection: Learning to Let Go of Perfect
  • What I Learned Building My Knowledge Base
  • My First Week with Obsidian + Quartz

Structure Tips:

  • Include date and title in frontmatter
  • Paragraph-based writing
  • May link to Notes for depth or references

🧩 When in Doubt...

If you’re writing... Use
A timeless idea or explanation πŸ“’ Note
A recent experience or evolving opinion πŸ“° Post
Something you’ll want to frequently link to πŸ“’ Note
A standalone article for readers πŸ“° Post
A rough, unfinished idea πŸ“’ Note (or keep as a draft)
A milestone, launch, or update πŸ“° Post

πŸ›  Tips

  • Use Posts to express.
  • Use Notes to understand.
  • Let one link to the other freely β€” e.g. a Post might reference a few key Notes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment