Create your first doc

Moment docs are plain-old Markdown files, stored in a git repository, on your device. In this guide, we will create a Moment doc, apply basic text formatting, and commit the changes with git.

Create a new Moment doc

After you download and install the Moment desktop app, and then run it, you will see a screen like the following. Click either of the high-contrast New Document buttons.

Loading...

Once done, you will see an empty Moment doc:

Loading...

Add and format some text

Moment docs are ultimately Markdown files, and they support Markdown syntax natively. See the Basic formatting reference for more details.

Try the following to put the editor through its paces:

Initially the Untitled placeholder at the top of the page will be focused. Type text to add a title to the page, and press Enter to focus the (currently empty) page contents.

Type some text into the editor. In the example below, we’ve typed Here is some test text!.

To create a heading, type a # followed by a space. For example, # My first heading in the example below.

Loading...

Highlight some text to the rich text toolbar. You can use this to make text bold, italic, strikethrough, block quote, bullet lists, and so on.

Loading...

Commit your changes

Once you have added some text, click the button in the bottom left that says Commit draft.

Loading...

This will bring up the commit modal. To commit changes, type a commit message describing your changes in the field in the upper left, and click Commit to main. In the following example, we’ve added the commit message My first commit.

Loading...

Once committed, you can press Escape or click the close button in the upper right to dismiss the modal and go back to editing the Moment doc.

Inspecting the files on disk

Because Moment docs are plain-old Markdown files stored on your device, we can inspect and interact with them as we do with any other files. To do this click the overflow menu in the upper left, next to the Moment doc title. You will see two options:

Reveal document on filesystem…, which opens the Moment doc folder using the relevant OS file explorer (e.g., macOS’s Finder), and

Copy path to document folder, which copies the path to the directory for use in, e.g., a Unix terminal.

Loading...

Clicking either of these will allow you to inspect the document, for example, as follows:

Loading...

Next steps

Try adding some interactive components.