This guide demonstrates how to publish a Moment doc to the public Internet as a web page. The shortest way to publish a Moment doc is two clicks, but this guide will cover customization options that many users may find helpful.

Prerequisites

Before starting this guide, you should have the following:

Create an account or log into the Moment service

Begin by navigating to a Moment doc you’d like to publish. Click the Share button in the upper-right corner.

If you haven’t created an account or logged into the Moment service, you will see a popover with a log in button:

Click this button to log in via GitHub.

⚠️ Moment currently requires a GitHub account. If you do not have a GitHub account, you will not be able to use the Moment service at this time.

Publish the doc

Now that you’re logged in, click the Share button again. This time, you will see a button to Publish the doc:

Some users may want to know exacty what happens when they click this button. Click What will this do? underneath the Publish the doc button. It will show you a plan resembling the following:

All Moment docs are plain-old Markdown files stored in a Git repository on your local device. In this plan, we can see that “publishing” is essentially (with some additional bookkeeping):

Click the button to execute this plan. The UI will update as these steps are executed. It will look like the following:

Once provisioned, the popover will look like this:

Click View site to go to the published site. In this case, the site looks like the following:

(Optional) Customizing the site template

Once published, click the Share button again. Now, click the Customize template, style, permissions button:

This will bring up the customization pane on the right-hand side:

The second option allows you to select a publishing template. Choose the template you’d like:

If you change your selection, you will see that the bottom of the customization pane has updated to reflect that you have made changes that you need to commit and push to take effect:

Click it to bring up the commit UI. Type a message describing your changes, like Change template to blog. Click the Sync to moment/main to publish the new changes.

⚠️ If this is your first time seeing the commit UI, you may wish to read the guide Committing changes.

Refreshing the URL, you will see the site template has updated:

Next steps

Congratulations! You have published a Moment doc as a web site. Any time you change the Moment doc, you can use the commit UI to synchronize your changes and publish a new version of the site.

For next steps, try the following: