Project: sphinx-markdown-tables

A Sphinx extension for rendering tables written in markdown

Project Details

Latest version
0.0.17
Home Page
https://github.com/ryanfox/sphinx-markdown-tables
PyPI Page
https://pypi.org/project/sphinx-markdown-tables/

Project Popularity

PageRank
0.001577668869026271
Number of downloads
80687

sphinx-markdown-tables

A Sphinx extension for rendering markdown tables.

Sphinx supports markdown via Recommonmark, which does not support tables. This extension provides them.

It renders markdown tables as HTML, as defined by python-markdown

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.

License

This project is available under the GPLv3 license. For other licensing arrangements contact Ryan Fox.