Note that we have 2 editor versions — "Basic markdown" & "Rich + Markdown" – that you can choose from here in your settings. They both offer the same features but the layout is slightly different between the two. Please check out both to see which editor version you'd prefer.
Follow the instructions below to post your first article.
0. Sign Up
If you don't already have an account, you'll need one to post an article. Join us!
1. Click "Write a Post"
Once you sign in, there will be a big button in the upper right corner that says "Write a Post" - click it!
2. Pick a Good, Descriptive Title
Most of the time, people will notice your title first and will often decide whether or not to read based just on that. So make that first impression a good one! Tell the readers exactly what they will get from the post, and then deliver on that promise. While it's nice to be catchy, it's often best to be direct and clear.
3. Add Some Tags
Tags are super important! Users can follow tags based on their interest, so appropriately tagging your posts will get your posts in the feeds of the correct people (who actually want to read that content!)
For tag ideas, check out this page to see the all time most popular tags.
4. (Optional) Choose a Cover Image
Click on the
add a cover images button in the post editor to open the image adding dialog, then choose a file to upload as your cover image. Cover images give visual interest to your post, plus they show up on Twitter if someone tweets out a link to your post!
5. Write Your Post!
Now we're getting somewhere...
You can write your post directly in the editor and even save a draft if you need a break and would like to continue writing later. Just click the
Save draft button (or
Save changes) at the bottom of the page.
Also, if you need help with formatting, look to the righthand side of the editor for the header "Editor Basics" which provides some guidelines on using Markdown, Liquid tags, and other features.
7. Add Images in the Body of a Post
You'll see an
Upload image button near the top of the page which you can use to upload image files. After choosing your image wait a second for it to upload.
Once it's done, there will be a markdown snippet with a link to your uploaded image. Copy that, and paste it right into the editor! Change the alt text (inside the square brackets) to something descriptive, and you're good to go.
8. Review Your Post in Preview Mode
Once you're done with a post, we'd recommend reading through the post at least once in "Preview" mode before publishing.
Preview at the bottom of your screen to see the formatted post.
9. Hoping to Post under an Org?
Look at the very top of the page for "Write a new post" and you'll see a dropdown that defaults to
Personal. Just change this to whatever org you'd like to post under if applicable. If you don't want to post under an org, just leave it be.
Once finished, you can publish your post!
If using the "Basic markdown" editor, you'll need to change the Front Matter so that
published: false reads
If using the "Rich + markdown" editor then you'll just click the
Publish button at the bottom of the page.
Need to Make an Edit?
No worries, you can always easily access all of your articles from your user dashboard to edit your posts if necessary.
To unpublish a post, you need to click to edit it and click the gear icon beside
Save changes to find the
Unpublish post button. Or, if you're using the "Basic markdown" editor, you'll simply change the Front Matter so that
published: true reads
If you completed the steps above, you've officially posted an article!
Top comments (0)