sphinx-markdown-tables 0.0.1

A Sphinx extension for rendering tables written in markdown

# sphinx-markdown-tables

A [Sphinx](http://www.sphinx-doc.org/en/master/) extension for rendering markdown tables.

Sphinx supports markdown via [Recommonmark,](https://github.com/rtfd/recommonmark) which does not support tables. This
extension provides them.

It renders markdown tables as HTML, as defined by [python-markdown](https://python-markdown.github.io/)

## Installation

pip install sphinx-markdown-tables

## Usage

### Quick version
Add `sphinx-markdown-tables` to `extensions` in `conf.py`, like so:

extensions = [
'sphinx-markdown-tables',
]

### Longer version
Sphinx needs to be configured to use markdown. First, you need `recommonmark`:

pip install recommonmark

In `conf.py`, configure `source_parsers` and `source_suffix`:

source_parsers = {
'.md': 'recommonmark.parser.CommonMarkParser',
}

source_suffix = ['.rst', '.md']

Once Sphinx is configured appropriately, add `sphinx-markdown-tables` to `extensions`, like so:

extensions = [
'sphinx-markdown-tables',
]

For more information on Sphinx and markdown, see the
[Sphinx documentation.](http://www.sphinx-doc.org/en/master/usage/markdown.html)