All posts

How to Organize Markdown Files on macOS: Folders, Tags, and Search

Master macOS organization for markdown files. Learn folder structures, naming conventions, Finder tags, Spotlight search, and how to set OpenMark as your default editor for .md files.

How to Organize Markdown Files on macOS: Folders, Tags, and Search

You've created 100 markdown files. Notes, blog posts, documentation, journal entries. Now you can't find anything.

This is a real problem. Markdown's great strength—it's just plain text files—becomes a weakness if you don't organize them. Unlike proprietary note apps with built-in structure, plain text requires intentional organization.

But the good news: macOS has excellent tools for organizing and finding plain text files. With the right folder structure, naming convention, and use of Finder tags, you can organize markdown files better than most note-taking apps.

The Folder Structure Approach

Start with a clear folder hierarchy. The specific structure depends on your use case, but here are proven approaches:

For Writers and Bloggers

markdown/
├── blog/
│   ├── published/
│   ├── drafts/
│   └── ideas/
├── personal/
│   ├── journal/
│   ├── notes/
│   └── goals/
├── projects/
│   ├── ProjectA/
│   ├── ProjectB/
│   └── ProjectC/
└── archive/

This separates blog content (with clear states: published, drafts, ideas), personal content, project-specific files, and old stuff you rarely need.

For Developers and Teams

markdown/
├── docs/
│   ├── architecture/
│   ├── api/
│   ├── contributing/
│   └── faq/
├── projects/
│   ├── [project-name]/
│   └── [project-name]/
├── notes/
│   ├── daily/
│   ├── meetings/
│   └── retrospectives/
└── templates/

This organizes documentation by function, links to specific projects, and keeps meeting notes and retrospectives accessible.

For Researchers and Students

markdown/
├── courses/
│   ├── PHIL101/
│   ├── PSYCH200/
│   └── STAT301/
├── research/
│   ├── topic-a/
│   ├── topic-b/
│   └── literature/
├── notes/
│   ├── permanent/
│   ├── fleeting/
│   └── bibliography/
└── thesis/

This uses the Zettelkasten-style system for building a knowledge base: fleeting notes (captured quickly), permanent notes (refined ideas), and reference material.

The key principle: organize by intent, not by date. Don't create folders named "2026-02" or "February Notes." Instead, organize by the type of content or its purpose. You want to open the "blog/drafts" folder and immediately see all draft blog posts.

Naming Conventions

Within folders, consistency in naming matters. Use a clear convention:

The Slug Convention

For blog posts, documentation, and project files, use "slug" style: lowercase, hyphens instead of spaces, descriptive.

2026-02-25-how-to-organize-markdown-files.md
react-hooks-best-practices.md
2026-q1-goals.md
meeting-notes-2026-02-20.md

Patterns:

  • Blog posts: YYYY-MM-DD-slug-title.md (date first, sortable by date)
  • Documents: slug-title.md (no date)
  • Meeting notes: meeting-notes-YYYY-MM-DD.md (date last, easier to scan)
  • Journal: journal-YYYY-MM-DD.md

Include the date in the filename if recency matters. Put it first if you want files sorted chronologically, last if you want them grouped by type.

The Number Convention

Some note-takers use a number prefix for organization:

001-principles.md
002-first-project.md
020-second-project.md
100-archived-stuff.md

This lets you control sort order explicitly. Useful for sequential documentation or course materials.

Finder Tags

macOS Finder tags are invisible but powerful. You can tag any file with colored labels and search by tag.

Right-click a markdown file > Tags, then add tags like:

  • important (red) — Files you reference frequently
  • review (orange) — Files that need editing or follow-up
  • reading (yellow) — Resources to read
  • quote (green) — Great quotes or reference material
  • template (blue) — Files to use as templates
  • archive (gray) — Old files you might not need but want to keep

Now you can search in Finder: Cmd+F, then filter by tag. Instant access to all "review" files, or all "important" notes.

Tags work across your folder structure. You don't need to reorganize files—just tag them.

Combine tags: a file can be tagged important and template and review at the same time. Filter for files with multiple tags to narrow your search.

Spotlight Search for Markdown

macOS Spotlight (Cmd+Space) is a powerful search tool. It indexes all files on your Mac, including markdown content.

Type Cmd+Space markdown format and Spotlight will find all files mentioning "markdown format"—searching inside the file content, not just filenames.

Pro tips:

Search for filetype: kind:markdown or kind:document shows only markdown files.

Search by date: modified:today or created:2026-02-25 finds files created/modified on specific dates.

Search in a folder: Click the file icon in Spotlight results to see which folder it's in. Then hit Cmd+Option+B to reveal it in Finder and explore the folder.

Search combined: kind:markdown review finds all markdown files mentioning "review".

Spotlight is fast, indexed, and built into macOS. Use it.

Setting OpenMark as Default App

Once you've organized your markdown files, you want to open them in your preferred editor.

To make OpenMark the default app for .md files:

  1. Right-click any .md file
  2. Select "Open With" > "Other..."
  3. Find OpenMark in Applications
  4. Click "Open" (or "Always Open With" if you see that button)
  5. Select "Change All..." to apply to all markdown files

Now double-clicking any .md file opens it in OpenMark. Cmd+O to open a file dialog from within OpenMark and jump between your files.

Alternatively, drag a markdown file onto the OpenMark icon in the dock. Or use Cmd+O from within OpenMark to browse and open files.

Local Storage vs. iCloud Drive

Where should you store your markdown files?

Local Storage (~/Documents or custom folder)

Pros:

  • Fast access (SSD, no network latency)
  • Version control friendly (Git works smoothly)
  • Privacy (stays on your Mac)
  • Works offline

Cons:

  • Need manual backup
  • Not synced across devices
  • Need to manage migration if you get a new Mac

iCloud Drive

Pros:

  • Automatic backup to Apple's servers
  • Synced across Mac, iPad, iPhone
  • Access from anywhere (iCloud.com)
  • Automatic migration to new Mac

Cons:

  • Slower than local SSD
  • Can have sync issues
  • Counts toward iCloud storage limit (5GB free)
  • Less suitable for Git version control

Recommendation

Use local storage as your primary location. Organize by the folder structures above. Use Git to version control important files (documentation, blog posts, projects).

For personal notes and journal entries, store them locally and back them up manually (or use Time Machine, which is automatic).

If you need access from iPad or iPhone, use iCloud Drive as a secondary location for those specific files.

Searching and Exploring

With proper organization, finding a file is fast:

  1. Know roughly where it is — You organized by intent, so use that. "Blog drafts" is obvious if you need a draft post.
  2. Use Spotlight if unsure — Cmd+Space, search for a keyword, find it instantly.
  3. Use Finder tags — Cmd+F in Finder, filter by the tags you applied.
  4. Browse the folder — Double-click a folder in Finder. macOS shows files sorted by name, date, size, etc.

Automation (Advanced)

If you're comfortable with automation, you can use AppleScript or Shortcuts to create markdown files with templates, automatically tag them, or organize them.

For example, a Shortcut that:

  • Prompts for a filename
  • Creates a markdown file with frontmatter (title, date, tags)
  • Opens it in OpenMark
  • Tags it automatically

But honestly, you don't need automation. A simple folder structure and Finder tags solve 90% of organization problems.

The System Should Disappear

The goal of good organization isn't to spend time managing files. It's to set up a system that works so well you forget about it. You create a file, save it to the right folder (second nature after a week), and never think about organization again.

When you need something, Spotlight finds it in milliseconds. You're back to writing.

That's what good organization does: it gets out of the way.

OpenMark integrates seamlessly with macOS file organization. Use OpenMark as your default markdown editor, organize your files in iCloud Drive or local storage, and let Spotlight and Finder tags handle the rest.

Download OpenMark for $9.99 on the Mac App Store.