Sphinx is a really useful tool, but one
shortcoming is its markdown support. Specifically, it uses the
recommonmark specification, which does
not support tables. I wrote a Sphinx extension to render tables authored in
It can be installed via
pip install sphinx-markdown-tables.
If you don't already have Sphinx configured …