What is Markdown?
Markdown is a way of structuring a plain-text document so that it can be converted into HTML by a computer. It was created by John Gruber who says of it:
Readability... is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.
An easy way to think of it is that Markdown is a human-centric way of composing something that will end up as a web page.
Where is Markdown used?
- Be able to explain the basic syntax of Markdown
- Create your first web page using Markdown
Let's get started!
Markdown will help you create easy-to-read web pages that are subsequently easy to edit. Markdown syntax is converted seamlessly into semantically correct HTML. All you need to do is write your document as text, adding the necessary syntax where necessary. Where Markdown finds the special syntax, it will automatically convert it into HTML for you.
This would be rendered like this:
It's worth getting to know the official Markdown syntax page provided by John Gruber. It's useful when you end up going beyond what this brief tutorial covers!
This should be enough to get you started:
#H1 text here,
##H2 text here (etc.)
*italic text here*
**bold text here**
[Linked text here](http://link_url.com/?test)
![My awesome image](http://link_url.com/image.jpg)
- If something isnt working..trying checking if you left some unwanted space between the syntax
- Both '*' and '_' underscores can be used in both and italics
- '+' , '*' or '-' can be used to generate unordered list
- You can use artibrary HTML in Markdown. So if you write some Markdown, then some HTML, and then some Markdown, it will all render in HTML.
Image attribution: CC BY-NC James Forsyth