Things to Know

• We use a markdown editor that uses Jekyll front matter.
• Most of the time, you can write inline html directly into your posts.
• We support native liquid tags and created some fun custom ones, too! Trying embedding a tweet or github issue in your post.
• Links to unpublished posts are shareable for feedback/review.
• When you're ready to publish, set the published variable to true.

Front Matter

Custom variables set for each post, located between the triple-dashed lines in your editor. Here are a list of possibilities:

• title: title of your article
• published: boolean that determines whether or not your article is published
• description: description area in Twitter cards and open graph cards
• tags: max of four tags, needs to be comma-separated
• canonical_url: link for canonical version of content
• cover_image: cover image for post, accepts url

Markdown Basics

Below are some examples of commonly used markdown syntax. If you want to dive deeper, check out this cheat sheet.

Bold & Italic

Italics: *asteriks* or _underscores_

Bold: **double asteriks** or __double underscores__

Links

I'm an inline link: [I'm an inline link](https://dev.to)

Headers

Add a header to your post with this syntax:

      
        #One '#' for a h1 header
##Two '#'s for a h2 header
...
######Six '#'s for a h6 header
      
    

One '#' for a h1 header

Two '#'s for a h2 header

Six '#'s for a h6 header

Liquid Tags

We support native liquid tags in our editor, but have created our own custom tags listed below:

Twitter Embed

Using the twitter liquid tag will allow the tweet to pre-render from the server, providing your reader with a better experience. All you need is the tweet id from the url. {% twitter 834439977220112384 %}

Github Issue or Comment Embed

All you need is the github issue or comment URL.

{% github https://github.com/thepracticaldev/dev.to/issues/9 %}

YouTube embed

All you need is the YouTube id from the URL.

{% youtube 9z-Pdfxxdyo %}