ASTER MD · MARKDOWN VIEWER AND EDITOR

Markdown, set as a page. Edit it where it stands.

A native markdown viewer and editor for Windows, built on the Aster UI kit. Every file opens at once as one rendered page that you edit directly, never as raw markdown.

Aster MD in the light theme: a recent-files list on the left and a synthetic field guide with a quote, a table and a task list.Drawn by Aster
  • Version 0.1.2
  • Windows, also runs on Linux
  • Early release
  • Comes with Aster Suite

EDIT THE PAGE

One page. You edit it directly.

Aster MD shows the file the way it will read. Click and type; the markdown is written for you.

  • Format with the keys you know: Ctrl B, I and E for bold, italic and code, Ctrl 1 to 6 for headings.
  • Start a line with "# ", "- ", "1. ", "[] " or "> " and it becomes a heading, list, task or quote.
  • Lists, tasks, quotes and code blocks are edited in place, and Ctrl Z and Ctrl Y undo and redo.
Aster MD in the light theme with a phrase selected and set in italic, and the title bar reading Edited.
A capture of the running app, just after a selection was set in italic.

OPENS AT ONCE

Open a file. It is already there.

Run it with a path and the file is on screen at once. Run it on its own and you get your recent files.

  • Drag a markdown file onto aster-md.exe, or choose Aster MD from Explorer's Open with.
  • A second launch hands its file to the window that is already open and exits at once, so ten double-clicks make one window, with all ten in its recent list.
  • A minimal recent-files list sits on the left; star the ones you keep coming back to.

--new-instance opens a separate window when you want one.

Aster MD started with no file: pinned and recent files on the left and a card that says to open a markdown file or press Ctrl O.
Started on its own: your recent files, ready to open.

VERY LARGE FILES

Designed for very large files.

Aster MD is built for very large, very complex markdown files, and keeps an edit as small as the block you touch.

  • Design target: the first screen of a 50 to 100 MB file with more than a million lines, in well under 100 ms on a loaded laptop.
  • Design target: typing, styling and structural edits cost the size of the touched block, never the size of the file.
  • One measurement we made: a synthetic 36,003-line, 2.5 MB file reached its first frame in 101 ms in the headless renderer, on a heavily loaded Linux test machine. That is one frame built with no window, not a window-to-pixel time, and not a result for the targets above.

Targets are what the design is built around, not measurements. Your machine and your files will differ.

Aster MD with a 36,003-line synthetic file open, scrolled to section 530, with a table, a task list and a code block.
A 36,003-line synthetic test file, scrolled to section 530.

Find anything. Run anything.

Two keys get you almost everywhere.

The commands palette open over a document, narrowed by the letters "the" to two headings and the Light theme command.

Commands palette

Ctrl K or Ctrl P opens one list of commands, the document's headings and your recent files. Type to narrow it, Enter to run.

Ctrl K or Ctrl P
The find bar open on the word "light", showing 1 of 3, with each match marked in the document.

Find

Ctrl F searches the document. Matches are marked on the page with a count, and Enter and Shift Enter step to the next or previous one.

Ctrl F, then Enter or Shift Enter

Light, dark, and set the way you read.

Pick a theme, a typeface pairing and a paper.

Aster MD in the dark theme: pinned and recent files on the left and a synthetic field guide with a quote, a table and a task list.

Light and dark

Light and dark themes. Your saved choice wins; otherwise Aster MD follows the system.

Light theme and Dark theme in the commands palette
The Typography panel open at the right: six pairings from Modern to Humanist, text sizes S to XL and measures Narrow to Wide.

Typography

The Aa panel has six font pairings, four text sizes and three line widths. Five paper stocks and a finish are a command away.

Six pairings, four sizes, three measures

Tables and code, edited in place.

The parts of a document that are hardest to edit are the parts you can edit directly.

A table with the cell "180 lm" selected, a ring around it, and sort and filter controls in the column headers.

Tables

A table edits like a small sheet: a ring around the cell, column menus for sort and filter, Tab to the next cell, and cells copy to and from a spreadsheet as tab-separated text.

Tab and Shift Tab move between cells
A Rust code block with coloured keywords and strings, line numbers and a Copy button, under a numbered list and a heading.

Code blocks

Code is coloured by language, numbered, and has a Copy button. Shift and the mouse wheel scroll a wide block sideways.

Rust shown here; other languages are coloured too

Careful with your files.

A markdown editor should never leave you wondering what it did to the file.

Exact saves

What you did not touch is saved exactly as it was: encoding, byte order mark, line endings and whitespace.

Windows-1252 and UTF-16 files are saved back the way they came

Crash recovery

A recovery journal is written from your first edit and removed when you save or close cleanly.

Kept in your profile, never beside your document

Changes from outside

If the file changes on disk while you have unsaved edits, the two are merged. When both sides changed the same words, both versions are kept between markers. Nothing is overwritten silently.

A failed save leaves the original untouched

Kinematic motion

Kinematic animation wherever it helps: the caret glides, lists and cards slide into place, and scrolling has a spring to it.

Reduced when the system turns animation off

Autosave

Ctrl S saves, and it also saves by itself a moment after you stop typing. Turn it off in the commands palette.

Ctrl S

Pictures and links

PNG, JPEG, GIF, WebP, BMP and TIFF show relative to the document. Ctrl click opens a link.

GIF shows its first frame

Platforms and requirements.

Windows is the shipping target. The same code also builds and runs on Linux.

Windows

One self-contained aster-md.exe: no installer needed, no runtime to add, no admin rights. Fonts come from Windows. Settings stay in your user profile, so a copy on a USB stick shares them with an installed one.

  • Opens .md, .markdown, .mdown, .mkd and .mkdn
  • Runs from any folder you can write to
  • Comes with Aster Suite, which keeps it up to date

Linux

It also builds and runs on Linux, with X11 or Wayland. The screens on this page were captured on Linux.

  • Settings in ~/.config/aster-md/settings.ini
  • A headless mode renders a screenshot with no window

Version 0.1.2 is an early release, and Aster MD is a working name. It comes with Aster Suite, which is not available yet.

Questions

Short answers, straight from the project's own notes.

Is this a markdown source editor?

No. You never see raw markdown. The file is one rendered page and you edit that page; the markdown is written for you, and the parts you did not touch keep their exact bytes.

Will saving change my file?

Only what you edited. Encoding, byte order mark, line endings and whitespace you did not touch are written back as they were. A Windows-1252 file is saved as Windows-1252.

How do I get it?

Aster MD comes with Aster Suite, which brings every Aster app with its own runtime built in. Aster Suite is not available yet.

What if it crashes before I save?

A recovery journal is written from your first edit, so unsaved edits can be recovered after a crash. It is deleted when you save or close cleanly.

Can I make it my default for .md files?

Windows lets only you choose the default app. Pick Aster MD under Settings, Apps, Default apps, or right-click a .md file, choose Open with, then Always.

How big a file can it open?

Aster MD is designed for very large files, and the targets are on this page, but they are targets. Try your own file and see.

Built with Aster

Aster MD is a desktop app made with Aster, the UI runtime that draws every pixel on this page's screens.

Try Aster MD.

Aster MD comes with Aster Suite, which is not available yet.