How to write markdown

Default avatar.
April 15, 2013
How to write markdown.

ThumbnailRecently, there's been a lot of talk about markdown as an alternate way to format text.

I decided to do a little research and see what all the talk was about and I was actually quite glad of what I found; markdown is simple markup language that makes it easier for writers to write good content for the web without having to worry about the HTML code in their articles.

The benefit of using markdown is that you can write substantially cleaner articles and it also makes it easier for anyone reading your articles to be able to read it, without actually opening the page in a browser.

How to write markdown

Writing markdown is the simplest thing you can imagine:

Bold and italic text

To create italic text you just need to surround the text by one star:

This is *italic text.*

Which will produce:

This is italic text.

And to create bold text you insert two stars:

And this is **bold text.**

Which will produce:

And this is bold text.

Headings

To create headings in markdown all you need to is add a hash sign before your content. One hash sign is the equivalent of an <h1>, two means an <h2> and so on until <h6>:

# this is an heading 1
## this is an heading 2
### this is an heading 3
#### this is an heading 4
##### this is an heading 5
###### this is an heading 6

Paragraphs

Writing paragraphs is as simple as writing your text, and if you want to add another another paragraph you just need to press enter and in the next line a new paragraph will be added:

One paragraph

And here is another paragraph

Is the equivalent of:

<p>One paragraph</p>
<p>And here is another paragraph</p>

Blockquotes

To create blockquotes you need to add a angled bracket (>) before the text you want, like so:

> Somebody said this quote some years ago

Which is the same as:

<blockquote>
<p>Somebody said this quote some years ago</p>
<blockquote>

Links

Creating links is very simlar to HTML, you first place the text you want the user to see inside square brackets and then place the link location inside a pair of parentheses:

[Webdesigner Depot](https://www.webdesignerdepot.com)

Which is the equivalent of:

<a href=”https://www.webdesignerdepot.com”>Webdesigner Depot</a>

Images

Images use the same basic syntax as links, but in images the text you place in square brackets will be the alt text and you also need to place an exclamation mark before everything to make markdown know that what you are writing is an image and not a link:

![My image](http://example.com/myimage.jpg)

Is the same as:

<img src=”http://example.com/myimage.jpg” alt=”My image” />

Unordered Lists

To create a simple unordered list you only need to create the list items, you don’t need to worry about opening and closing the list. All you need to do is to add a line break, then add an asterisk before each item:

* One list item
* Another list item
* And a third one

Is the equivalent of:

<ul>
<li>One list item</li>
<li>Another list item</li>
<li>And a third one</li>
</ul>

Ordered Lists

Like the unordered lists you only need to concern yourself with the actual list items, there's no opening or closing. To use an ordered list you just need to use numbers instead of asterisks:

1 One list item
2 Another list item
3 And a third one

Is the equivalent of:

<ol>
<li>One list item</li>
<li>Another list item</li>
<li>And a third one</li>
</ol>

Conclusion

Markdown is a really good backup if you write articles for the web and you are not a savvy HTML developer, it really facilitates the creation of content for the web. There is even a Wordpress Plugin that allows markdown in posts and comments and automatically converts it to HTML.

Have you learnt to use markdown? What benefits have you found over other forms of markup? Let us know in the comments.

Featured image/thumbnail, blogging image via Shutterstock.

Sara Vieira

Sara Vieira is a freelance Web Designer and Developer with a passion for HTML5/CSS3 and jQuery. You can follow her on twitter or check out her website.

Read Next

3 Essential Design Trends, November 2024

Touchable texture, distinct grids, and two-column designs are some of the most trending website design elements of…

20 Best New Websites, October 2024

Something we’re seeing more and more of is the ‘customizable’ site. Most often, this means a button to swap between…

Exciting New Tools for Designers, October 2024

We’ve got goodies for designers, developers, SEO-ers, content managers, and those of you who wear multiple hats. And,…

15 Best New Fonts, September 2024

Welcome to our roundup of the best new fonts we’ve found on the web in the previous four weeks. In this month’s edition…

3 Essential Design Trends, October 2024

This article is brought to you by Constantino, a renowned company offering premium and affordable website design You…

A Beginner’s Guide to Using BlueSky for Business Success

In today’s fast-paced digital world, businesses are always on the lookout for new ways to connect with their audience.…

The Importance of Title Tags: Tips and Tricks to Optimize for SEO

When it comes to on-page SEO, there’s one element that plays a pivotal role in both search engine rankings and user…

20 Best New Websites, September 2024

We have a mixed bag for you with both minimalist and maximalist designs, and single pagers alongside much bigger, but…

Exciting New Tools for Designers, September 2024

This time around we are aiming to simplify life, with some light and fast analytics, an all-in-one productivity…

3 Essential Design Trends, September 2024

September's web design trends have a fun, fall feeling ... and we love it. See what's trending in website design this…

Crafting Personalized Experiences with AI

Picture this: You open Netflix, and it’s like the platform just knows what you’re in the mood for. Or maybe you’re…

15 Best New Fonts, August 2024

Welcome to August’s roundup of the best fonts we’ve found over the last few weeks. 2024’s trend for flowing curves and…