How to use

Get started on our simple writing platform.

Everything on is based around plain text. Formatting happens with text; adding images happens with text. Even embedding videos and other multimedia happens with text.

In short, we use a special kind of syntax called Markdown that lets you format text (like I just did) with a few special characters. Here's what it looks like:

# Header 1
## Header 2
### Header 3

* Bulleted
* List

1. Numbered
2. List

**Bold** and _Italic_ and `Code` text


(horizontal rule):

If you put that in the editor and press publish, you'll see this:

Header 1

Header 2

Header 3

  • Bulleted
  • List
  1. Numbered
  2. List

Bold and Italic and Code text



(horizontal rule): also does its best to support the exact spacing you put in your posts.

So you can freely add new lines.

And even get creative with your s p a c i n g

Our goal is to be as intuitive as possible, using that thing you already have your hands on — your keyboard. Don't be afraid to try out different things and see how they work!

Sticking with our text-based nature, lets you easily group your posts together with hashtags. Add one at any point in your post, like #this, and it'll automatically be linked to a special page that shows all posts containing that hashtag.

Hashtags are also sent to the fediverse. So if your blog has federation enabled, your tagged blog posts will show up with all the other posts that people have similarly tagged when someone does a search in Mastodon, Pleroma, etc.

You can also add as many hashtags as you want to your posts, with any kind of capitalization:

#tutorial #HowTo #organization #WriteAs

As mentioned in our previous post, you can add photos with a little Markdown:


This inserts an image in your post, pulled from the given URL, that will read “Image” to anyone using a screen reader. We'd highly advise writing something more descriptive here, to help out any visually impaired users.

In order to get a URL for your image, it'll need to be hosted somewhere on the internet. We have an integrated photo hosting platform called that'll let you do exactly this — Pro users get it as part of their subscription, and can connect their account here.

Once you have a account, you can use the browser extension (available for Chrome and Firefox) to upload a photo and quickly add it to your post, like this:

Read more about this on the blog.

#tutorial #HowTo #photos #SnapAs

You can show only the beginning of your post on your blog's home page with a bit of special text. If you're on our blog's home page, you'll see a “Read more...” link below.


You can permanently pin any blog post to your blog's navigation bar (like an “About” or “Contact” page) by following these steps:

  1. Publish a post to your blog
  2. Go to your blog home page by clicking your blog name in the top-left corner
  3. Hover over the post
  4. Click Pin

That's it! You'll see a link to that post from every page on your blog.

Note: on, this requires a Pro or Support subscription.

Here's what it looks like in practice:

#tutorial #HowTo #StaticPages #writeas #writefreely

Creating a draft on / WriteFreely is easy. From the dropdown menu in the editor, select “Anonymous” (called “Draft” in WriteFreely) before publishing, write your post, and then press the Publish button. That's it!

This will create a post at a secret, but shareable, URL. You can choose to share that URL with someone you'd like to have review your draft, or just keep it to yourself to have it remain private. Now, you can continue editing this draft and saving updates with the Publish button. You can find it listed on your “Posts” page (again called “Drafts” in WriteFreely).

When you're ready to publish to your blog, navigate to your Posts / Drafts page, scroll down to your post, and click “move to {your blog}”. (If you have multiple blogs, instead you'll see a dropdown menu that says “move to...”) Once you do that, your post will be live on your blog!

#tutorial #HowTo #drafts #writeas #writefreely

Enter your email to subscribe to updates.