Technical Marketing Guide

A travel guide for technical marketing – get inspired and start exploring yourself.

How to get started with Markdown: Your new best friend when writing any line of text

Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

Daring Fireball: Markdown

This is how John Gruber, one of the inventors of markdown, explains the the tool as he calls it. It already sounds more complicated than it is. I suggest just to jump in. In this post I show you how to get started with Markdown …

These are a few lines of markdown formatted text:

# First Headline (H1)

## Second Headline (H2)

This is a really short sentence with some **bold text**, some *italics* and a link to an [Example-Page](

* a bullet
* another bullet

>This is a quote

1. Numbered Item
2. Another Numbered Item

![Example Image](

A markdown enabled App will turn these lines into this:

First Headline (H1)

Second Headline (H2)

This is a really short sentence with some bold text, some italics and a link to an Example-Page

  • a bullet
  • another bullet

This is a quote

  1. Numbered Item
  2. Another Numbered Item

Example Image

So what happened here?

  • The Markdown App turns the markdown formatted text into valid html.
  • This HTML code can be pasted wherever you need the text (Mail, WordPress, your Website …)
  • You can also copy the formatted text for use in Pages or Word.

Why do I need this?

  • You’ll be able to write formatted text in every text-app, even on your phone without the hassle of a complicated interface.
  • You’ll be able to write simple HTML-Code without ever learning how to code.
  • You can use the HTML-Code for the web (your blog and website)
  • You don’t have to worry about who opens the file. After all, its just plain-text.
  • You can use themes to style your text with the click of a button. (You’ll need an app like Marked for that.

Ok, I’m convinced, where do I start?

  • Check out this Markdown Cheat Sheet. For starters you’ll do fine with my list of examples above as well.
  • Get a markdown app for desktop and mobile.
    • I highly recommend Byword as it has clients for the iPhone, iPad and Mac. It syncs over iCloud and Dropbox and has a really nice clean interface.
    • Don’t want to spend money right away? Go with Mou, it doesn’t have the different apps and sync but on Mac it does a really good job!

Further reading (for the real markdown-fan-boys)

Maybe start with the stuff above before digging into these following tips:

Right-Click-Conversion of Markdown to formatted Text (great for Mail)

This is what we’ll achieve:

formatted text to markdown

  • Install MulitMarkdown for your Mac. It’s the one that starts with MultiMarkdown-Mac. Pick the newest version.
    • When intalling you might get a security warning. Retry but instead fo double-clicking, right-click the install-file and than hit and hold your ALT-Key before clicking open.
  • Download Brett Terpstras Markdown Service Tools
  • Head over to your library (Open the Finder ▸ Go to (hold down the alt key) ▸ Library ▸ Services
  • Copy “md – Convert – Multimarkdown to RTF” into that empty folder.
  • Restart Mail. Done.

Markdown Presentations

Deckset Presentations

I havent tried this one but it sure looks really promising. Deckset turns your markdown notes into beautiful presentations. There is also free alternatives but Deckset sure does look really nice.

Editorial – The ultimate Markdown app for iPad

Editorial is, simply put, the best writing app on the iPad. I won’t describe it at length here because Federico Viticcis extensive review already does a perfect job there. So perfect that he turned it into a book called “Writing On The iPad: Text Automation with Editorial

If you decide to dig into the Editorial app and also Viticcis Book be sure to look at this great comic on xkcd once in a while …

Automation ...

Let me know if you know other great usages of Markdown …

Next Post

Previous Post

Leave a Reply

Never miss another guide, sign up now

Cookie Settings

© 2018 Technical Marketing Guide