DEV Community

Cover image for Writing: The Two Editors
Nathan Kallman
Nathan Kallman

Posted on Writing: The Two Editors

When you start writing on, the first thing you need to choose is which editor you'd like to use (there's two!).

Choose which you want before writing in Settings > UX. settings to choose between the available editors; Basic markdown and Rich + markdown

You can use either the "Basic markdown" editor or the "Rich + markdown" editor. (Personally, I've always used the "Rich + markdown" for all my posts; and I would recommend it to start learning

The Basic markdown editor

As the name implies, this editor is bare bones. Just an image upload section, a large input for your article and front-matter (i.e. all the meta information like title and tags), and a button to save and a button to revert changes. image uploader with uploaded image front matter example editor Save and Revert buttons

If you want to learn more about the front matter or what supports in article writing, check out the editor guide.

The Rich + markdown editor

A much "nicer" UX from the Basic editor (and by "nicer" I mean more helpful hints and more guiding of the user in how to use it). Instead of one gigantic input for both article content and meta-data; there's a set of form fields for (most of*) the front-matter; The title, the cover image (which can be a gif!), and tags. rich editor for meta-data

The image uploader has stayed the same, and is above the article writing area. image uploader with uploaded image

The remaining* "front matter" is located at the bottom of the editor.

A Publish button (does what you think), similar save and revert buttons as the basic editor, and a hexagon with a circle in it (aka Post options). Publish, Save draft, Post options, and Revert editor buttons

Clicking that Post options button will pop up a widget to allow editing the canoncial url and the series (series creates a nice ordered list of posts at the top and bottom of every article that is a part of the series, like this article has; canonical url points to where the article was originally published if you're re-publishing from your personal blog or Medium or ...). Series and Canonical URL editor pop-up

* the "description" piece of front matter is available in the basic editor but as of writing doesn't seem to be editable from the Rich + markdown editor

Other things articles are written in Markdown, but also support Liquid tags for extra special content. Read all about it in the editor guide.

And if you're ever unsure about how Markdown and Liquid tags will work or look, the editor has a preview option above and to the right.

Edit and Preview modes of the editor

When you upload an image, a box containing the appropriate Markdown to include the image in the post will appear (if you've uploaded multiple at once, the Markdown gets appended for each one). Make sure to set the Alt Text for accessibility when you copy/paste the Markdown into the appropriate place in your article. image uploader with uploaded image

Hope this mini-tutorial helped encourage you to start writing here on DEV. Be sure to checkout the next post in this series: Making a series! It came from a question here on

If you have your own question, just ask in a comment. I read all of them and would love to add another post in this series that will actually help other writers in this awesome community!

Top comments (1)

abhidatta0 profile image
Abhirup Datta • Edited

Thanks for the info. Now the path to choose the markdown editor have been updated to Settings -> Customization.