Skip to main content

Dashes, asterisks and plus signs

Posted in Tools

As a designer, I enjoy details. Markdown has lots of ways of doing the same thing and this is kind of nice, but also makes me sweat.

I’ve always been of the mind that each bit of syntax should be distinct. e.g. Because asterisks are used for <strong> emphasis, I prefer not to use them elsewhere. So I use underscores for regular emphasis (<em>) and + for lists. This also nicely avoided using dashes for lists, as they’re too close to underscores for my liking: _ versus -.

Before I used Markdown, I used Textile. Textile is fine, but Markdown is better and much more widely used, so at one point I made the switch. Textile uses underscores for regular emphasis so maybe that’s why I’ve always preferred that syntax.

I suppose an underscore on each side of some text looks more slanted, like italicised text. That’s probably why Textile uses them, and why Markdown supports them.

Going against the grain

My commitment to the cause has made my life a wee bit more difficult, in that most writing apps output asterisks with + i, not underscores. So I’ve been bloody minded and insisted on typing the underscores myself, rather than using every app’s built-in keyboard shortcuts.


But italics aren’t the point. The semantics of it are simply ‘emphasis’ and ‘strong emphasis’. Not ‘forward-leaning in the same weight font’ and ‘upright letters but in a heavier weight font’.

My conclusion

You’ve got regular and strong emphasis, not italics and bold (though this is normally how it looks visually). So asterisks should be used for both: one asterisk for regular and two for strong.

You can even use three asterisks for extra strong (which would output <strong><em>content like this</em></strong>. I’m more comfortable with ***content like this*** than **_content like this_**. Plus it stops me wasting energy on whether the underscores should be on the outside or the inside of the asterisks!

Can of worms

So now that I’m not using underscores in my Markdown, does that mean I should start using dashes for lists…?

(I think I will – most Markdown writing apps insert - with the + l keyboard shortcut.)


If you enjoyed reading this and want a monthly roundup of my articles delivered to your inbox, just enter your email below.

I don’t collect any data on when, where or if people open the emails I send them. Your email will only be used to send you newsletters and will never be passed on. You can unsubscribe at any time.

More posts

Here are a couple more posts for you to enjoy. If that’s not enough, have a look at the full list.

  1. Using Pandoc to convert Markdown to Jira’s Textile in Sublime Text

    It’s a real pain that Jira’s plain text input isn’t Markdown. Here’s how to I write in Markdown and export to Jira’s version of Textile.

  2. Apple dials back the Safari 15 for macOS redesign

    The ultra-condensed tab bar in the up-coming Safari for macOS has been reverted in the betas; it’s now just an option in Safari’s Preferences.