TreeNote
Sign inSign up
Guide & Methodology

Markdown vs outliners: two different shapes for notes

Compare Markdown and outliners for note-taking, writing and project planning. Understand the difference between plain-text files and nested, movable ideas.

2 min read•469 words•Updated for 2026

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 TreeNote fits

TreeNote 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

Plan in a tree. Publish in a file.

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

Put these ideas into practice

TreeNote provides a fast, flexible outliner built around these principles. No sign up required to start.