Skip to content
אצלי
Go back

A visual Markdown editor for Standard Notes, with the note kept as plain Markdown

Updated:
Milkdown editor inside Standard Notes, with a floating icon bar at the top, the Milkdown feature tour note with front matter, a table of contents and a selected heading with the selection toolbar, and the fixed formatting bar at the bottom

Also available in Portuguese: Um editor Markdown visual para o Standard Notes, com a nota guardada como Markdown puro.

After the API client and the Kanban board, this is the third plugin of the set: StandardNotes-Milkdown, a visual Markdown editor for Standard Notes built on Milkdown Crepe.

The idea is the same as in the other two: the note stays plain text. The plugin only changes how you edit it, so the note remains readable, searchable and exportable, and it is end-to-end encrypted like the rest of your data.

Standard Notes with the Milkdown editor open on a note called "Sample". A floating icon bar sits centered at the top. The note shows a front matter block, the title "Milkdown feature tour", a table of contents with the note's headings and the heading "Text and links", with the word "links" selected and a floating toolbar above it. At the bottom, the formatting bar with the Heading 2 selector and the count "1 of 310 words"

The note in the image is the one the Add sample button creates in an empty note: a tour of what the editor can draw, with front matter, a table of contents, lists and todos, the five alerts, a table, code, math, diagrams and an image.

What it has

Visual editing of the whole Markdown feature set without seeing the source: headings, lists, todo lists, tables, links, images, blockquotes and code blocks with syntax highlighting. A floating toolbar on the selection, a / slash menu and drag handles add and move blocks.

The / slash menu open on an empty line of the feature tour note, on the Advanced tab, listing Ordered List, Task List, Image, Code, Table, Math and Table of contents, with Image highlighted. The icon bar at the top shows "310 words · 2 min"

On top of that:

The Math and Diagrams sections of the sample note. An inline formula, a^2 + b^2 = c^2, and a LaTeX block with its preview, the Gaussian integral. Below, two Mermaid blocks with their source and preview: a flowchart from Idea to Draft, Review and Done, and a sequence diagram between You and Editor

Images uploaded, pasted or dropped are embedded in the note. Up to 500 KB they go in as they are, and larger ones are scaled down and recompressed, since the note syncs to every device.

Three modes

The icon bar at the top switches between Visual, Split and Source. Split puts the Markdown source next to the visual editor, side by side or stacked, and Source is a plain CodeMirror pane for fine-grained edits.

The Split mode. On the left, the Markdown source of the note, with the front matter, the headings and the [TOC] line as text. On the right, the same note drawn by the visual editor, with the table of contents and the "Text and links" section. The icon bar shows "310 words · 2 min"

The icon bar floats at the top, centered, and folds away with the > button, leaving only a small < in the corner to bring it back.

The icon bar folded away, leaving only the note "Milkdown in Standard Notes" with a list, todos, a table, a blockquote and a code block, and the formatting bar fixed at the bottom with the Heading 1 selector and buttons for bold, italic, strikethrough, code, lists, link, image, table, code block, quote and rule

Layout choices are saved with the editor in your Standard Notes account. On narrow screens the split view stacks, and below 520 px the secondary actions move into a ... menu.

The note stays Markdown

The body of the note is CommonMark plus GitHub Flavored Markdown: tables, task lists and strikethrough.

# Shopping

- [x] bread
- [ ] coffee

| Item  | Price |
| ----- | ----- |
| bread | 2.50  |

> [!NOTE]
> Everything stays in the note as plain text.

Energy: $E = mc^2$

```mermaid
graph LR
  Idea --> Draft --> Done
```

Nothing is stored outside the note, so opening the same note with the built-in editor shows identical content. Opening a note never rewrites it, and nothing is saved until you edit. Undo never reaches into the previously opened note.

The first edit is where the editor leaves its mark: it rewrites the whole note in the shape the visual editor writes. The visible changes are small:

What the editor keeps exactly as written is the list that matters for imported notes: YAML and TOML front matter, GitHub alerts, [[wiki links]], footnotes, inline HTML, inline math and the [TOC] line. Notes that come from GitHub, Obsidian, Jekyll or Hugo are not rewritten.

One known limit: Crepe stores the resize ratio of an image in its alt text, so resizing an image that has alt text replaces the alt with the ratio, for example ![0.50](https://...).

Installation

  1. In Standard Notes (web or desktop), open Preferences, then Plugins.

  2. At the bottom of the page, paste the URL below into Install Custom Plugin:

    https://esli.cafe/StandardNotes-Milkdown/ext.json
  3. Create a note, open the Editor menu and pick Milkdown.

The app checks that URL for updates, so new releases arrive on their own. It works on the web, desktop and mobile apps and follows the theme selected in the app.

Privacy and weight

The editor has no AI features and no network access of its own. The only remote content it loads is images linked by URL in the note, and Mermaid renders diagrams with its strict security level. The page’s Content Security Policy allows scripts and connections only from the plugin’s own origin, and the HTML export carries a policy of its own that blocks scripts entirely.

The cost is size: the main chunk is about 390 KB gzipped. KaTeX, about 80 KB gzipped, loads in its own chunk at startup, Mermaid only when a note has a diagram, and code block languages on demand.

If the editor ever fails to render, the raw note text stays available and editable in a plain text area, and edits are still saved.

How it is built

It is React 18 and TypeScript, built with Vite, on top of the Standard Notes editor-kit. The visual editor is Milkdown Crepe 7 (MIT), which edits with ProseMirror and reads and writes Markdown with remark, with remark-frontmatter for the front matter. Keeping alerts, wiki links and [TOC] as written takes a tuned serializer: custom mdast-util-to-markdown handlers stop it from escaping their brackets, and ProseMirror decorations draw them. Source mode and the Markdown side of Split are CodeMirror 6, find and replace in the visual editor is prosemirror-search, math is KaTeX, and diagrams are Mermaid, its SVG passed through DOMPurify before it reaches the page. Vitest with fast-check covers the logic, and Playwright drives the built plugin through a fake Standard Notes host, including the opaque origin and slower CPU of the mobile app.

The current version is v1.0.0, AGPL-3.0 licensed. The code is at github.com/Esl1h/StandardNotes-Milkdown.


Share this post on:

Previous Post
Kanban inside Standard Notes, with the board saved as Markdown
Next Post
RTK 1.0: atualizando e economizando milhões de tokens