Some Links

https://pythonhosted.org/Markdown/index.html

A good link

A better? http://daringfireball.net/projects/markdown/syntax

An even better? https://learnxinyminutes.com/docs/markdown/

From github: https://guides.github.com/features/mastering-markdown

On jinja and context http://stackoverflow.com/questions/31830663/how-to-render-template-in-flask-without-using-request-context

From WordPress https://en.support.wordpress.com/markdown-quick-reference/

Extensions

https://github.com/waylan/Python-Markdown/wiki/Third-Party-Extensions

https://pythonhosted.org/Markdown/extensions/

Note on attributes and images etc...

The resizing of the image with the attribute lists (or attribute lists all together) will work if the attr_list is enabled in markdown calls... so for example:

![image](https://octodex.github.com/images/yaktocat.png "This is a tooltip"){: width=200px}

will work if the call to markdown is (for example):

body   = markdown.markdown(input_body, extensions=['codehilite', 'fenced_code', 'tables', 'attr_list'])

The resulting image is 100px (and I put it in a table... why not?)...

The Table

Check out tables generator

In this page this is workding because of the

FLATPAGES_HTML_RENDERER = prerender_jinja

and the code itself is:

def prerender_jinja(text):
    prerendered_body = render_template_string(Markup(text))
    pygmented_body   = markdown.markdown(prerendered_body, extensions=['codehilite', 'fenced_code', 'tables', 'attr_list'])
    return pygmented_body

Of course then one can use any class from CSS etc. For example I make the google.com link button in markdown using Bootstrap class like this:

[google.com](http://google.com){: class="btn btn-info" title="a title? really?" type="button" target="_blank"}