Folders

Folders let you organize your documents into a nested hierarchy, up to 3 levels deep. Create folders for projects, topics, or any grouping that makes sense for your workflow.

Common uses include documentation sets, blog series, course materials, company handbooks, and project portfolios.

Create a folder from the sidebar context menu or the New button. Give it a name. You can also create subfolders inside existing folders (up to 3 levels deep).

• Folder names can be up to 100 characters
• Each folder gets its own URL slug for public folder pages
• Nesting supports up to 3 levels: root folder, subfolder, sub-subfolder
• Each document belongs to at most one folder

Move documents into folders by dragging them in the sidebar, or by right-clicking and choosing "Move to..." from the context menu. You can also use multi-select (Cmd+Click or Shift+Click) to move multiple documents at once.

Moving a document to a new folder automatically removes it from the previous folder. To move a document back to the root level, choose "Unfiled" in the Move to dialog.

Each folder has a public/private toggle:

• Public folders: Visible on your author profile, included in the sitemap, accessible to anyone via the folder URL
• Private folders: Only visible to you. Useful for organizing your own documents without exposing the grouping to visitors

Changing a folder between public and private takes effect immediately. Public folders include JSON-LD CollectionPage schema for search engines.

Public folders have their own URL structure under your username:

• Folder page: unmarkdown.com/u/[username]/c/[slug]
• Author profile (shows folders): unmarkdown.com/u/[username]

Folder URL slugs follow the same validation rules as document slugs. You can change a folder's slug at any time, but the old URL will stop working immediately.

When you delete a document, it moves to the Trash section at the bottom of the sidebar. Trashed documents are kept for 30 days, during which you can restore them to their original location.

• Trashed documents are excluded from your document count and folder listings
• Restoring a document returns it to its previous folder (or unfiled if the folder was deleted)
• After 30 days, trashed documents are permanently deleted
• You can permanently delete documents from the Trash at any time

You can rename, delete, and reorder folders from the sidebar. Deleting a folder moves all documents inside it to unfiled. The documents themselves are not deleted or unpublished.