Getting Started

You're about to meet your new favorite writing tool. In just 5 minutes, you'll have Ritemark installed and your first document created.

Let's go.

Download and Install

Ritemark is available for macOS (Apple Silicon and Intel) and Windows. On a Mac it needs macOS 12 Monterey or later and about 2 GB of free disk space. On a PC it needs 64-bit Windows 10 or later.

On macOS, download the DMG for your Mac from the download buttons on the homepage or the GitHub releases page. Open it and drag Ritemark to your Applications folder.

On Windows, install Ritemark from the Microsoft Store. The Store downloads and installs it for you. If you can't use the Microsoft Store on your computer (some work machines block it), download Ritemark-Setup.exe from the GitHub releases page and run it instead.

That's it. Installation done.

💡 Tip: On a Mac, after dragging, you can eject the disk image by right-clicking it and selecting "Eject".

First Launch on macOS

Ritemark for Mac is notarized by Apple, so it opens like any other app. The first time, macOS may ask whether you want to open an app downloaded from the internet. Click Open.

If macOS blocks an older download, get the latest version from the releases page above.

Opening a Markdown File Right Away (v1.8.6)

You don't have to open the app first. Double-click any .md file on a fresh install and it opens straight in the Ritemark editor, formatted and ready to type in. There is no "do you trust the authors of the files in this folder?" dialog, no plain-text code view, and no Restricted Mode banner across the top.

If you installed an earlier version and got stuck with that dialog or a permanent Restricted Mode banner, update to v1.8.6. Affected profiles repair themselves on the first launch after the update.

First Launch on Windows

If you installed from the Microsoft Store, you'll find Ritemark in your Start menu, and it opens like any other app.

If you ran Ritemark-Setup.exe from GitHub instead, Windows SmartScreen may show a blue "Windows protected your PC" warning the first time. This happens because Ritemark is a new application and hasn't built up enough download history with Microsoft yet. It's not a security issue.

To get past it, click More info on the warning screen, then click Run anyway. The installer will launch normally. You only see this once.

For a detailed walkthrough with screenshots, see Windows SmartScreen Warning.

Open Your First Folder

Ritemark works with folders, not individual files. One folder holds your documents, and the sidebar shows all of them in one place. Folder is the only word Ritemark uses for this, so there is nothing to learn about workspaces or projects.

Home sits at the top of the activity bar on the left and stays there. Click it any time and you get one panel with everything you need to start or resume:

New document as the big primary button
Quick actions for New AI task, Open document, New table, and Open folder
Recent documents, so a file you had open yesterday is one click away. With nothing open yet, this list shows recent folders instead

Click Open folder... and select any folder on your computer. If you don't have one ready, create a new folder called "My Notes" or similar. Your folder now appears in the sidebar, and the file tree is where you move around it.

Create Your First Document

Here's the fun part. Press ⌘N, or click New document on Home, or use File -> New Document. Name it something like hello.md and press Enter. File -> New Table does the same for a spreadsheet.

The file opens in the editor. Start typing — your text appears beautifully formatted as you write.

🎉 Congratulations! You've just created your first Ritemark document.

Three Things to Try Right Now

1. Slash Commands

Type / and a few letters to filter the menu

Type / anywhere in your document. A menu appears with all available block types:

/heading1 creates a large heading
/bullet starts a bullet list
/task adds a checkbox item

Try typing /heading1 and pressing Enter. Magic.

2. Quick Formatting

Select any text you've written. A floating toolbar appears with formatting options. Click B for bold or I for italic.

Even faster? Use keyboard shortcuts: ⌘B for bold, ⌘I for italic.

3. Relax — It Auto-Saves

Notice there's no save button? Ritemark saves your work automatically, about a second after you stop typing. The status bar at the bottom shows you when the file was last saved.

No more lost work. No more "did I save that?" anxiety.

Watch the AI Work in Your Files

This 90-second film shows the whole first request in the app: open a folder, open a page, ask in plain words, and read what the AI changed. It uses Codex, signed in with a ChatGPT account. With a paid Claude plan or your own API keys, the steps are the same.

What's Next?

You've got the basics down. Here's where to go from here:

Set up AI assistant — Ritemark's AI sidebar includes Claude Code, Codex and OpenCode, which can help you write, edit, and brainstorm in your files. Sign in with a paid Claude plan or your ChatGPT account, or add your own API keys for OpenCode. Set up the AI sidebar.

Explore the editor — Learn about all the block types and keyboard shortcuts to speed up your workflow.

Export or publish your work -- Share your markdown as PDF or Word, or, as of v1.12.0, publish it as a Google Doc that Sync keeps up to date. See export options and Publish to Google Docs.

Read Word, PowerPoint and PDF files -- Click a .docx, .pptx or .pdf file and it opens as a read-only preview next to your writing. PowerPoint slides are new in v1.12.0. See Document Preview.

Open web pages alongside your writing -- As of v1.7.0, .html files, external URLs, and localhost:* open as rendered pages in the same tab bar as your markdown. It's a real browser inside Ritemark, useful for previewing exports, checking references, or running a local docs server.

Check for updates -- The new Update Center in Settings lets you check for updates, install them with pause and resume support, and skip versions you don't want. No more downloading DMGs manually for most updates.

Quick Reference

What you want to do	How to do it
Create a new document	Press ⌘N, or click New document on Home
Create a new table	File → New Table, or New table on Home
Open a folder	Open folder... on Home, or File → Open Folder
Reopen something you worked on	Recent documents on Home
Insert a heading	Type `/heading1`
Make text bold	Select text, press ⌘B
Start a bullet list	Type `/bullet`
Export to PDF	Click Export → PDF

Stuck?

Check out Common Issues for solutions to frequent problems, or browse the full support documentation for detailed guides on every feature.

Happy writing!

Contents