In the heyday of my old blog I used to write all my posts in HTML (Hypertext Markup Language), the universal coding language of the Web. This gave me complete control over the formatting, including fints, text size, the placement of photos on the page, etc. HTML is a fairly complex language or notation which may seen hard to master for the beginner. It is, however, a perfectly logical system and is easier to learn than you might think. For the purposes of writing a blog, though, a fairly small subset of codes will usuallly suffice.
HTML consists of a set of “tags”, indicated by enclosing them in a pair of angle-brackets “<” and “>”. In most (but not all) cases, you need a pair of such tags, the first to “switch on” the effect and the second to “switch it off” again. For example, if I want to make a word bold I would write the HTML code thus: <strong>bold</strong>. (Note the forward slash in the end-tag.
In the first line of this post, I included a link, that is, a phrase that when you click on it, sends your browser to the webpage in question, though the actual URL (the “Web address”) is discretely hidden. To write that in HTML is a little bit complicated. It would be:
Example 1: <a href=”https://tigergrowl.wordpress.com”>old blog</a>
If that seems a little bit messy, then you probably do not want to know what the code looks like for including an image, sizing it and positioning it on the page! (If you really want to know what that looks like, you should probably consult one of the many excellent online HTML tutorials!)
When I started this blog, my intention was to write all my posts on my iPhone. Writing HTML would have been possible on the mobile but rather awkward. So I had either to give up the idea of formatting my text or of find another way to do it. Happily, there is another way. It is a system called Markdown.
What attracted me to Markdown? For one thing, the coding is simpler and easier to understand and use than HTML. The only problem is that you cannot use it direcly in the WordPress editor but there is an easy work around. If you want to write using Markdown on your phone, you can install a free Markdown editor app such as Pretext.
Once you have composed your post in Pretext’s editor, you click on the up-arrow symbol at top right, then on “Share Document” and when a list of your apps appears, select the WordPress app. The text will appear in the proper place and it you have indicated the title of the piece (by prefixing it with the # symbol), it will appear in the title space.
If you sometimes want to write your posts on the PC, then you can find a number of specialized Markdown editors but I haven’t bothered with them. Instead I looked at programmers’ editors, some of which can also handle Markdown. A good example is one of the online community’s favourite programmers’ editors, called Notepad++. Not only is this an excellent editor for writing anything from plain text to programming code but it also exists both as an installed application and as a portable app. As if that were not enough recommendation, it is free!
The best way I have found to use Notepad++ for writing posts in Markdown is to write a few words of text and then save to a file with a .md extension. From then on, anything you write in Markdown will appear as the code indicates but will also show the coding symbols. (Specialized Markdown editors often have two displays, one showing the marked-up text and the other showing how it will appear when published. I prefer to see it all on one display.) Once you publish the text, by copy-pasting into to your WordPress blog editor, the coding will disappear and only the effects will remain. Let me give you an example of Markdown coding. Consider the following sentence:
Example 2: We can easily include words in italics and in bold.
To achieve that with Markdown code, you write:
Example 3: We can easily include words in *italics* and in **bold**.
Enclosing words or phrase in a pair of single asterisks puts them in italics while a pair of double asterisks makes them bold. I think you will agree that that is simpler than the HTML equivalent with tags in angle-brackets. In Notepad++, you see the asterisks as well as their effect but once you copy and paste the text into the WordPress editor, the asterisks disappear, as you see in Example 2.
What about including links in your text? That too is delightfully simple, compared with HTML. Referring again to the link in the first line of the post, what I wrote in the editor was this:
Example 4: [old blog](https://tigergrowl.wordpress.com)
The square brackets indicate the text that remains visible and the round brackets contain the actual URL which will remain invisible but be used redirect the browser.
There is a lot more that you can do than this, of course, though Markdown is by no means as complete as HTML. The latter is still needed for “serious” projects, but you can go a long way with Markdown and it is probably sufficient for writing most blog posts.
Where can you find out what the codes are? There are many Markdown references and cheat sheets available online. A couple of handy ones are the WordPress Markdown quick reference cheat sheet and CommonMark’s Quick Reference.
To end with, here is a little puzzle. If you copy-paste HTML code into the WordPress editor, the angle-brackets disappear and the code is enacted. How then did I manage to write and keep visible the HTML code in the sentence I have labelled Example 1? By all means leave a comment if you think you know the answer 🙂