A Mild Complaint

awwsmm profile image Andrew (he/him) ・1 min read

...actually just two problems.

  1. As far as I can tell, there is no obvious link to the Dev.To Editor's Guide which (really reads more like an "Author's Guide" and) is a supremely useful resource for when I forget how to format a liquid tag or something in a post. I think I had to discover for myself that you can embed Dev.To users and posts within your own posts and comments.

    Embed a user with {% user jess %}:

    jess image

    or a post with {% link awwsmm/getting-the-gist-of-java-15eg %}

    or even a specific comment with {% devcomment 6hpe %}

    Yo dawg, I heard you like browsers.

    There are also embeds for Twitter, Glitch, GitHub, Gist, and lots more. The ability to do this is really cool and I don't think I would have known about it if I hadn't stumbled across the Editor's Guide.

  2. How do I do this?

    Other people seem to know how to make a series of articles into a series of articles, but it's not in the Editor's Guide. Help!


Another thing I only just discovered: you can add a Table of Contents to the top of your post using inline anchors:

## TOC
  * [Chapter 1](#chapter-1)
  * [Chapter 2](#chapter-2)
  * [Chapter 3](#chapter-3)

Posted on by:

awwsmm profile

Andrew (he/him)


Got a Ph.D. looking for dark matter, but not finding any. Now I code full-time. Je parle un peu français. dogs > cats


markdown guide

It's the little information icon on every post or comment you author?

information icon

I agree it could do with having a link somewhere common, like maybe the footer, but it's on the page contextually where it's needed.


Nice! But that's only how it appears on comments. On posts, it's different:

So I propose two things:

  1. A unified UI across posts and comments
  2. Adding all of this info to the Editor's Guide, and making the Guide a permanent fixture on the user drop-down menu.

Holy crap that's how you do that.

A wholehearted "second" - even discovering "cover_image" was a little tricky. The message "just paste it into your editor" is only half the battle!


You can add a series to your posts by adding the series tag in the front matter of your post. For example:

title: Cool title!
tags: some, tags, here
series: The Name of Your Series

Your post here...

Just refer to the same series name to add the post to the series. Our great friend Ben here created an entire changelog for it.


Ah! I see! And in the V2 editor, you can click on the ... button at the top-right to open this window:


This PR just got merged to help 🙂

Though I suspect it still may not be fully clear. We need to keep working on this.


Thanks, I learned the trick. :)


That actually showed me a lot of things I didn't know. Thanks!