Start here

Getting Started

Welcome to Slate, a fast, native editor for Markdown, code, and everything in between. This short tour gets you from a fresh install to your first document, and shows you where everything lives.

Welcome to Slate

Slate is a fast, native editor for Markdown, code, and the rich content that lives alongside them. Deep search, a command palette, and instant rendering keep you moving with zero lag. Find it, write it, and never break flow.

When you open a Markdown document, Slate shows it three ways at once: a plain-text editor for people who want to see the raw syntax, a WYSIWYG editor for people who want to write as if it were a word processor, and a reading view that looks like the finished page, with code, images, diagrams, and math rendered in place.

You do not have to pick one. Switch between them at any time, or put two side by side. The document is always one file on disk, and every view stays in sync.

Install and open

Download Slate from the homepage. The desktop builds for macOS, Windows, and Linux are about 8 MB and install in a few seconds. There is no account to create and nothing to configure first.

On first launch, Slate opens to a welcome screen with two columns: your recent files on the left and your open workspace folders on the right. Use the New file, Open file, or Open folder buttons at the bottom, or drag any .md file onto the window. The same actions live in File → Open and in the sidebar.

The hint row at the bottom of the welcome screen calls out the two shortcuts you will use most: KCtrlKsearch and /Ctrl/slash commands. Both open the command palette.

Your first document

Type # Hello Slate on the first line and press Enter twice. You have a heading. Type **bold** and you get bold text. That is the plain-text view, and it gives you complete control over the syntax.

Now click WYSIWYG at the top of the editor. The same content appears as formatted text. You can keep typing here, or use / to open a menu of blocks to insert. Whatever you write gets saved back as standard Markdown.

Finally, click Reading. This is the view you would print or share: read-only, optimized for long-form reading, with code, math, and diagrams already rendered.

The view switcher

The interface at a glance

The window has four regions. Learn these once and the rest of Slate is just variations on the same layout.

The four regions of the Slate window
  1. Sidebar. Your open folders and their files live on the left. You can collapse it to a thin rail for more writing space, or hide it entirely.
  2. Tabs. Each open document is a tab. A small dot next to the filename means there are unsaved changes.
  3. View switcher. The segmented control in the top-right toggles between Plain, WYSIWYG, and Reading. Use the keyboard shortcut you see in Keyboard Shortcuts if you prefer not to reach for the mouse.
  4. Editor. The main area is whichever view you have selected. In split mode it is the editor on the left and a live preview on the right.

Where to go next