Skip to content

ryanfox/sphinx-markdown-tables

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

A markdown table plugin for Sphinx

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages