Choosing a format

Markdown vs outliners: two different shapes for notes

Markdown is a lightweight plain-text format for writing documents and files. An outliner is a structured way to organise ideas as nested, movable items. They can work together, but they solve different problems: Markdown prioritises portable files; outliners prioritise flexible hierarchy.

6 min read

A document versus a tree

Markdown begins with a file. You type plain text, use simple formatting syntax and can open the result in many editors. An outliner begins with an item in a hierarchy. You add children, indent, collapse and move sections as your thinking changes.

Markdown is excellent when the document is the thing you want to preserve: a README, article, specification or plain-text archive. Outlining is excellent when the relationship between ideas is still changing: a project plan, book structure, research tree or set of meeting decisions.

What Markdown does well

  • Keeps notes in readable, portable plain-text files
  • Works across many editors, publishing tools and version-control workflows
  • Supports writing where formatting and document structure matter
  • Makes it easy to keep one file as a durable, shareable artifact

What outliners do well

  • Move a point and its children without manual cut-and-paste
  • Collapse detail and zoom into one branch of a larger structure
  • Keep tasks, notes, dates and hierarchy in the same working tree
  • Support rapid keyboard-first capture and reorganisation

Choose based on what changes most

If you primarily revise prose inside files, Markdown is a strong default. If you constantly rearrange sections, turn ideas into tasks or need one connected workspace for notes and projects, an outliner is usually more natural. Many people write the final document in Markdown while using an outliner to plan and organise everything behind it.

Where SpacebarX fits

SpacebarX is an outliner rather than a folder of Markdown files. It is designed for work where hierarchy, movement and retrieval matter every day. OPML import and export keep the outline portable when you need to move it — there is no Markdown file import or export, so a vault of Markdown notes converts to OPML first. If you are weighing it against a Markdown-based tool, the Obsidian comparison is the closest case.

Questions

Is Markdown an outliner?
No. Markdown can contain headings and lists, but an outliner treats each nested item as a working unit you can move, collapse and develop directly.
Should writers use Markdown or an outliner?
Use an outliner to plan and restructure; use Markdown when a plain-text manuscript or publishing workflow is the priority. Many writers benefit from both.

Plan in a tree. Publish in a file.

Most people need both — the question is which one holds the thinking.