Markdown tables not rendered as tables

[mikecharles]

I'm using the following command:

pdoc test.py --html

to create an API doc for the following Python script:

#!/usr/bin/env python

def test():
    """
    Test function

    | Tables        | Are           | Cool  |
    | ------------- |:-------------:| -----:|
    | col 3 is      | right-aligned | $1600 |
    | col 2 is      | centered      |   $12 |
    | zebra stripes | are neat      |    $1 |
    """
    pass

Here's the resulting HTML:

Shouldn't pdoc handle any standard markdown syntax?

[mikecharles]

Sorry, nevermind, I didn't even realize tables were not a part of standard Markdown. Would it be easy to add it with this?

[BurntSushi]

I generally like Github's version of Markdown, so I wouldn't mind swapping what we have for that.

However, I think my strongest preference would be for CommonMark. Does that have tables?

[mikecharles]

Seems like many people don't think tables should even be part of the core spec for Markdown in version 1.0, so it's probably far off...

[robmoggach]

+1 for tables...

maybe a pluggable rendering engine would be nice??

[cortesi]

Please see #153 for a unified discussion ticket about docstring flavors.