Writing workflow

Write your first article

Articles are your project's knowledge vault. Block-based markdown with slash commands for citations, source images, evidence-scanning, and links that auto-build your knowledge graph as you write.

note.md article editor with a formatted markdown document, inline citations and source images

Articles are the knowledge foundation of a note.md project — your vault for everything you write, every link you draw between ideas, every cited passage. Here’s how a first article comes together.

01Open and create

Hit + and start writing.

Reach the article space from the sidebar or with + 2. Click + to create your first article and you land directly in the editor, with a single blank block waiting for your cursor.

It looks like markdown, but it isn’t really markdown — it’s a block-based editor that writes markdown for you. You can compose a whole document without typing a single # or [](). To change what a block is, you do what you do for most things in this editor: type /.

A new, blank article in the note.md editor, ready to fill
01 — A fresh article opens straight into the editor
02The command palette

Twenty-five commands, three families.

Type /anywhere and a palette appears with every block type and action the editor knows. Twenty-five commands in total — but they fall into three families, and once you can see the shape of the menu the actual commands become obvious.

Citation & Linking

/cite
/citation · /reference
Cite a source with optional bookmark.
/link
/url · /md-link
Insert a Markdown link.
/wiki
/wikilink · /page-link
Pick a page and insert a UUID-based wiki link.
/pdf
/source-link
Insert an internal link to a project PDF.

These four build the knowledge graph as a side effect. Every /cite and every /link, /wiki or /pdfis recorded as a connection — to a source or to another article. The new edges appear automatically in Graph View, where you can label each one with a relation type.

The Scan command

/scan
/evidence · /challenge · /triangulate
Find supports, contradicts, or nuanced sources for the current claim.

Treats the current block as a claim and queries your library for sources that back it up, contradict it, or qualify it. See step 4 for the full workflow.

Everything else.

The other twenty commands are the standard editor toolkit — the things you’d reach for in any block editor, grouped so the palette stays scannable when you type /.

Headings & structure

/h1
Large section title.
/h2
Medium section title.
/h3
Small section title.
/h4
Caption-sized title.
/divider
Visually separate content.
/toc
Generate links to headings on this page.

Text & lists

/text
Start with plain text.
/bullet
Organize with bullets.
/numbered
Step-by-step list.
/todo
Track tasks.
/quote
Capture highlights.

Blocks & callouts

/code
Insert a code block.
/panel
Confluence-style panel/callout.
/callout
Emphasize a note.
/expand
Collapsible details section.
/math
Render KaTeX equations.

Tables

/table
Insert a 2-column table.
/table-3col
Insert a 3-column table.

Media

/image
Insert from article attachments.
/insert
Pick extracted images, charts, and tables from project sources.
The /insert command in note.md showing a picker of figures, charts and tables extracted from project sources
03 — /insert opens a picker over your project's extracted assets
03Premium · /insert

Pull figures straight from your sources.

When automatic indexing runs on your library, note.md extracts every figure, chart and table from your PDFs into a project-wide asset pool. The /insertcommand opens a picker over that pool — choose the asset you need and it lands in your article, attributed to the source it came from.

Inserting your own images from the article’s attachments instead? That’s /image.

04Local AI · /scan

Treat any block as a claim — check what your library says about it.

Place your cursor in a sentence you’ve just written — or one you’re unsure about. Type /scan. note.md treats that block as a claim and searches every passage in your knowledge management library for sources that support, contradict or nuance it.

The results panel ranks matching text snippets next to the source they came from. When one fits, insert the citation straight from the panel — it lands in your prose anchored to the exact passage that justified it.

/scandoesn’t write the sentence for you. It reminds you what you’ve read.

A /scan result panel in note.md showing supporting text snippets from the user's literature library for the current claim
04 — Supports, contradicts, nuanced — straight from your own library
Common questions

About writing in note.md.

What's the difference between a block editor and a markdown editor?
A markdown editor asks you to type the syntax yourself (# for headings, ** for bold, []() for links). A block editor lets you change the type of any block with a menu — type / and pick 'heading' or 'quote' or 'code block' without ever typing a symbol. note.md is the second kind, but it stores everything as plain markdown files behind the scenes, so you get the speed of a block editor and the portability of markdown together.
How do I link notes to each other and to sources?
Four slash commands inside the editor: /wiki to link to another article in your project, /cite to cite a specific bookmark inside a PDF, /pdf to link to a project PDF directly, and /link for external URLs. Every one of those creates an edge in your knowledge graph automatically — you don't have to maintain it separately.
Can I check whether my own library supports a claim I'm making?
Type /scan on any block. note.md treats that block as a claim and searches every passage in your knowledge management library for sources that support, contradict, or nuance it. You see ranked text snippets next to the source they came from, and can insert the citation directly from the panel — anchored to the exact passage that justified it.

Try this workflow on your Mac.

note.md is free on the App Store. Premium unlocks the local-AI steps.

Download on the App StoreFree on the App Store