Hendrik

Posted on Sep 10, 2018

How to add code highlighting to your Dev.to posts.

#explainlikeimfive #postwriting #markdown #codeception

The simple truth of the matter is that:

const turorialFunction = (name) => {
  console.log(`Hello ${name}`)
}

does look way nicer than:

const turorialFunction = (name) => {
  console.log(`Hello ${name}`)
}

when writing a post here on Dev.to.

How to do it

Dev.tos posts are based on Markdown. Within Markdown we can use identation or so called Code Blocks to specify sections of code. The later ones are indicated using ```. Read more about this in this cheatsheet.

Using the three ` variant we can also specify a language for the code block. A lot of tooling build on top of Markdown utilized this characteristic to implement richer features. But the simplest of them is code highlighting. The above nicely colored code snippet is achieved by starting the code block with ```javascript.

The full example for the above would be:

```javascript
const turorialFunction = (name) => {
  console.log(`Hello ${name}`)
}
```

And if you are now wondering how the hell I got that to display:

<pre>
```javascript
const turorialFunction = (name) => {
  console.log(`Hello ${name}`)
}
```
</pre>

and the inline code is: <code>```</code>.

Here is where my explanations stop and your colorful posts start.

The list of supported languages is impressive, though not all encompassing (check comments).

Top comments (41)

Maxime • Jun 7 '19 • Edited

Does anyone know if dev.to supports highlighting lines of code or combining the diff highlighter with a language highlighter?

My use case is to draw attention to new or update lines of code when I write tutorials.

Something like this:

I know we can use diff but I can't find a way to combine that with code highlighting:

function hello() {
-  alert("Hello!");
+  alert("Hi!");
}

Lanae BK • Mar 25 '20

I am also trying to figure out how to do this - did you ever find an answer?

Maxime • Mar 27 '20

I didn't ☹️

rhymes • Sep 10 '18

I did a quick search in the code: dev.to uses the Redcarpet Ruby library to parse Markdown with rouge which does the highlighting part.

The list of lexers is impressive:

Dart:

void main() {
  print('Hello, World!');
}

Julia:

println("hello world")

No Cobol though :D

You can find the code in devto here and here and here

Kishor Jena • Jun 12 '22

Can you tell me the name of the theme for JS. I hope this available in vscode.

Max Cerrina • Sep 11 '18

Also shoutout for the "how I got this to display" part because I sure WAS wondering how you got the literal ```javascript to display

rhymes • Sep 11 '18

yeah, that's great, I would have used screenshots :D

Hendrik • Sep 11 '18

Glad that part is helping 😁

Hendrik • Sep 10 '18

Ahh interesting aspect. I will make sure to mention that above. Haven't looked into the fundamentals of dev.to but I guess they are using a code highlighter somewhere and are only including a limited amount of plugins, as in language support, to keep bundle size down.

Maybe a good candidate for improvement 👍

erikest • Apr 9 '19

shell and console don't seem to add much flavor. I was hoping at least for some #comment coloring...

Stevie G • May 17 '19

Thanks mate! Exactly what I was looking for!

Martinez • Feb 5 '23

You can try change the language

function CSS {
    console.log(`this is a example whit the flag css`)
}

function Typescript {
    console.log(`this is a example whit the flag typescript`)
}

I say this in case someone thinks that javascript is the only language that works.

Anand Kumar • May 5 '19

Hi @hendrik ,
Is there a way that I can change the background colour of the code block from black to white? Like theming or something?

Hendrik • May 5 '19

I don't think there is. The code highlight is basically a markdown feature and how it looks is defined by dev.to globally. But providing a theme to use for code blocks could be a cool feature for the Frontmatter, I agree.