This is my Jekyll based blog, hosted on Github. As all content in Jekyll is written in Markdown, I’ve decided to take this opportunity to teach myself/document as many parts of markdown as I can.
(This has been borrowed heavily from documentation found on Daring Fireball)
Update: Found a solution for syntax highlighting at Pygments
There appear to be various ways to create header elements in Markdown:
** From hence forward, just know that html can be used anywhere in Markdown
Any sequence of lines that all begin with the character > followed by a space will be wrapped in blockquotes, like this:
Any other special characters that are accounted for at the beginning of lines will still work within the context of blockquotes
Any set of characters that are surrounded by underscore, or asterisk characters will be italicized like this
Any of set of characters that are surrounded by two underscore, or asterisk characters will be boldicized like this
Use three underscores or asterisk characters for both bold and italics
Any lines that begin with one of these characters will be part of an unordered list (asterisk, plus, minus)
can be used
can as well
** Note: you can mix and match… YAH!!!
Any lines preceded by a digit followed by a period will be numbered. Doesn’t have to start with one (but will start with one when rendered anyway):
Also, paragraphs can be utilized within the lists through the use of indentation, like this:
Pretty straightforward, the hyperlink text should be enclosed in square brackets () and then the hyperlink should immediately follow it enclosed in parentheses. Example
Pretty sweet, you can embed links that can be referenced later in the document by, again, wrapping the hyperlink text in square brackets and then immediately following it with the reference text. Like this:
Sites that I frequently visit include [Hacker News], [Life Hacker], and [Engadget] ... Other text goes here ... * : http://news.ycombinator.com * : http://lifehacker.com * : http://engadget.com
Note that the reference can be numbers or text, though the text is case insensitive.
Image tags work like hyperlinks, only the square brackets are preceded by an exclamation point, and the brackets would contain the alt text associated with the image tag. references work here as well. Would look like this:
I see myself using this one often. I already have several times in this post! :) Any lines indented by a hard tab or four spaces will be wrapped in a <code> block which will basically escape it from being processed by the markdown parser (and also give it nice formatting on the page). Would really be handy for code blocks. On a related note, I should figure out how to add code blocks that provide syntax highlighting features for commonly used programming languages.
### Testing code block So, this is an example of what can be done using code blocks * All + of - this 1. Will be escaped.
Thus, the first blog post is completed.