Metadata-Version: 2.1
Name: sphinx-markdown-tables
Version: 0.0.17
Summary: A Sphinx extension for rendering tables written in markdown
Home-page: https://github.com/ryanfox/sphinx-markdown-tables
Author: Ryan Fox
Author-email: ryan@foxrow.com
Project-URL: Bug Reports, https://github.com/ryanfox/sphinx-markdown-tables/issues
Project-URL: Say Thanks!, https://foxrow.com
Project-URL: Source, https://github.com/ryanfox/sphinx-markdown-tables/
Keywords: sphinx markdown tables
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# 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)

## License
This project is available under the GPLv3 license. For other licensing arrangements contact
[Ryan Fox.](https://foxrow.com)
