This is pretty old now, but it should absolutely be mentioned that you can NOT always fall back to html - I suspect that MOST places that support markdown don't support html.

Markdown provides shorthand for the most common features of HTML. One of its best features is that you can always fallback to the full syntax for HTML. This includes doing things that aren't included in markdown. Personally, I like that markdown is concise and includes very little fluff. It makes it easier to learn the whole set of shorthand. This is particularly important if you expect someone else to read your code later.

GitHub Pages supports two Markdown processors: kramdown and GitHub's own extended CommonMark processer, which is used to render GitHub Flavored Markdown throughout GitHub.

Switch from redcarpet to kramdown, the new Github Pages default

快捷键 Ctrl + N 创建一个以 .md 为文件扩展名的 Markdown 文件

2.6 The Normal Distribution

Tables

This makes it easy to use Markdown to write about HTML code. (As opposed to raw HTML, which is a terrible format for writing about HTML syntax, because every single < and & in your example code needs to be escaped.)

On top of standard Markdown blockquotes, which require prepending > to quoted lines, GFM supports multiline blockquotes fenced by >>>:

Make your own automatic blogroll This is the script I use to generate a blogroll from my OPML: #! /usr/bin/env python3 """ Parse OPML into markdown. """ import sys import re from xml.etree import ElementTree def main(fname): with open(fname, 'r', encoding='utf8') as fp: tree = ElementTree.parse(fp) for cat_node in tree.find('body').findall('outline'): print("\n## {}\n".format(cat_node.get('title'))) for node in cat_node.findall('outline'): name = node.attrib.get('text') feedurl = node.attrib.get('xmlUrl') url = node.attrib.get('htmlUrl') print("* [{}]({}) ([feed]({}))".format(name, url, feedurl)) if __name__ == "__main__": main(*sys.argv[1:])

MDX is a superset of Markdown. It allows you to write JSX inside markdown. This includes importing and rendering React components!

Extending the markup

As of this writing, Markdown has no syntax for specifying the dimensions of an image; if this is important to you, you can simply use regular HTML <img> tags.

Hartl’s Tenth Rule of Typesetting Any sufficiently complicated typesetting system contains an ad hoc, informally specified, bug-ridden, slow implementation of half of LATEX.

Modern science has proved that the fundamental traits of every individual are indelibly stamped in the shape of his body, head, face and hands—an X-ray by which you can read the characteristics of any person on sight.

Markdown

people