What is markdown?
Markdown is a way of writing a document, but what’s so special about it? And what actually is it?
I should start by stating how important Markdown is. It’s very important. It’s a future-proof way of writing, and it’s perfect when you’re writing for the web.
“But what actually is Markdown!?” I hear you ask… Well, it’s a way of writing a document using characters like
- to format the text, which means the document can be written and/or on any text editing or word processing software application.
How is that different?
When you write a document you’ll probably be accustomed to highlighting a word, clicking the ‘B’ button, for example, and the highlighted text will become emboldened.
What you see is what you get!
This ‘what you see is what you get’ priciple (or WYSIWYG for short) is how print works. You design something and press ‘print’ and what you saw on the screen arrives at your printer.
This principle has shifted slightly as the web has become mainstream, this last decade or so. The problem on the web is, what your visitors get isn’t necessary what you had in mind when you wrote your content!
Separating your content from how it looks is the key to future proof articles!
Plain text and up
You don’t even need a proper word processor. You can write Markdown in Notepad on your Windows machine, TextEdit on your Mac, Notes on your iPad, iPhone or Mac. Anywhere you can write text, you can write in Markdown. Even your email program!
This is because it can be—and often is—written in plain text. No formatting at all.
But doesn’t that mean it’s ugly?
Yes and no. It’s plain text. So a word that you want to embolden or italicise won’t actually be bold or italics, necessarily, but they’ll look it. A bold word or phrase will be surrounded by two asterisks, which makes it stand out from the rest of the text; a header will be on its own line and will be underlined in some way.
So if you were to write—say—an email using Markdown, then sent it to a family member who has no idea what Markdown is, they’d have a good idea of what you’re trying to convey with those double asterisks around a word as it’ll look like it has been emphasised!
If you want to know more about how a document is actually written, have a look at this article on writing Markdown
Even though Markdown itself conveys the meaning of the text, it could be argued that it’s not especially pretty… The beauty of Markdown is that it’s understood by loads of programs, so you can import markdown and the program will make the text look great. No Markdown formatting– just bold and italic words, headings, quotations, etc.
The most useful place that this happens is on the web. If you write a blog, the chances are you can copy and paste your Markdown text straight into your blog or website’s control panel, hit ‘save’ and it’ll convert it into HTML on your website!
Because it’s plain text, it means it’s portable. It’s not locked down to any proprietery format* like Microsoft’s .doc, Apples .pages.
*By ‘format’ I mean the little extension you see after your file when you look at it in Windows Explorer (Windows) or Finder (Mac). For example, ‘my-great-document.docx’ (a Word document) or ‘Annual Report.ood’ (and OpenOffice document).
So if the maker of the word processing software you use go out of business or decide to stop supporting the format you’re writing in, your content is safe as you’ll have saved it as a Markdown document.
What’s more likely is that you change the word processing software you use. I did, way back when I bought my first Mac. I had always used Word when I used Windows machines but Pages looked like a nice option when I bought my Mac so I invested in that (a great decision, by the way!). Luckily Pages understands the .doc format so I could still access all of my old documents, but had it been the other way round I’d be stuck– Word (at least at the time of writing) doesn’t support the .pages format.
Personally, I use a text editor called Byword to create and edit my articles. It has iPhone, iPad and Mac versions so I can begin writing a post on my phone on the way to the office and pick it straight up on my laptop when I sit down at my desk!
Markdown allows you to open, edit and save a file in any word processor or text editor you like, then pick it up again in another! Flexibility is a wonderful thing!
I’ve said it a few times, but part of the beauty of Markdown files is that they’re written in an open format. The files are usually saved with a .md file extension, but can also be saved with .txt, which signifies a ‘text’ file, which is as generic as they come!
In fact, .txt files have been around since the dawn of computing. There aren’t many other computer-related things you can say that about!
Taking that one step further, your computer’s software is written in plain .txt files. And always will be. So .txt is here to stay. Even if Microsoft and Apple disappear (unlikely but at least possible) your documents will still be in a readable format.
So if you want to keep your documents forever, for use in as many different contexts as possible—whether you’re writing for the web or not—you should look into using Markdown to write them.
Are you already using Markdown? I’d love to know how you use it– why not leave a comment below!?
Never miss a resource
Do you have a website? Not the technical type? Join to receive free tips, useful to anyone looking to get the most out of their website.
Your email won’t be passed to any third parties or used in any way that won’t be of benefit to you. Also, you can unsubscribe at any time.