Getting started

Four steps: install, open a .md, edit, save. That’s the whole loop.

1. Install

  1. Grab the build for your OS from the download page.
  2. macOS: open the downloaded app. Gatekeeper may ask you to confirm the first launch — that’s normal for apps outside the Mac App Store.
  3. Windows: run the installer. SmartScreen may warn on a first-time publisher — choose to run when you’re ready. Bliss needs WebView2 (usually already on modern Windows).

2. Open a file

File → Open, drag a .md onto the window, or double-click a Markdown file once Bliss is your default handler. The document opens as a readable page — headings, lists, and tables look like a document, not a wall of syntax.

Recent files show up so you can jump back without hunting through folders. You can also create a new empty Markdown file from the app when you want a blank page.

3. Edit

Switch into edit mode when you need to change something. Type naturally; use familiar Markdown shortcuts where they help (# for headings, lists, and so on). Bliss aims for Notion-style comfort without turning your file into a proprietary format.

v1 is a viewer and editor only — no AI features inside the app. Bring drafts from Claude or ChatGPT; Bliss just treats them as documents.

4. Save

Save writes real CommonMark + GFM back to the same path on disk. Only the parts you actually changed get rewritten; untouched regions stay byte-for-byte. That’s theround-trip promise — open the file in another editor orgit diff and you should see edits where you made them, not a wholesale reformat.

What next?