{"id":8672,"library":"sphinx-markdown-tables","title":"Sphinx Markdown Tables","description":"sphinx-markdown-tables is a Sphinx extension designed to render tables written in GitHub Flavored Markdown (GFM) within Sphinx documentation projects. It enables users to utilize familiar Markdown table syntax for documentation generated by Sphinx. The current version is 0.0.17. While not on a strict release cadence, it receives updates for bug fixes and compatibility with new Sphinx versions.","status":"active","version":"0.0.17","language":"en","source_language":"en","source_url":"https://github.com/ryanfox/sphinx-markdown-tables/","tags":["sphinx","markdown","tables","documentation","extension","gfm"],"install":[{"cmd":"pip install sphinx-markdown-tables","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Runtime dependency for integrating with Sphinx documentation projects.","package":"sphinx","optional":false}],"imports":[],"quickstart":{"code":"# conf.py\n# Minimal Sphinx configuration for sphinx-markdown-tables\n# Make sure you have 'myst_parser' installed if using .md files.\n# pip install myst-parser\n\nproject = 'My Markdown Tables Project'\ncopyright = '2024, Example Author'\nextensions = [\n    'myst_parser', # Required for Sphinx to parse .md files\n    'sphinx_markdown_tables' # The extension itself\n]\n# You would also set source_suffix appropriately, e.g.,\nsource_suffix = {\n    '.rst': 'restructuredtext',\n    '.md': 'markdown',\n}\nhtml_theme = 'alabaster' # Or any other Sphinx theme\n\n# Example index.md content for using markdown tables:\n# ```markdown\n# # My Document\n# \n# Here is a table:\n# \n# | Header 1 | Header 2 | Header 3 |\n# |----------|----------|----------|\n# | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 |\n# | Row 2 Col 1 | Row 2 Col 2 | Row 2 Col 3 |\n# ```","lang":"python","description":"To use `sphinx-markdown-tables`, add it to the `extensions` list in your Sphinx `conf.py`. This example also includes `myst_parser`, which is commonly used to enable Sphinx to parse Markdown files (`.md`). After configuration, you can use GitHub Flavored Markdown (GFM) table syntax in your Markdown source files, and Sphinx will render them as HTML tables."},"warnings":[{"fix":"Ensure you have `myst_parser` (or similar) installed (`pip install myst-parser`) and added to your `extensions` list in `conf.py` alongside `sphinx_markdown_tables`. Also configure `source_suffix` to include `.md`.","message":"Using `sphinx-markdown-tables` with `.md` files requires an additional Markdown parsing extension (e.g., `myst_parser`) to be enabled in `conf.py`.","severity":"gotcha","affected_versions":"All versions"},{"fix":"If issues arise after a Sphinx upgrade, check the `sphinx-markdown-tables` GitHub issues for known compatibility problems or try updating `sphinx-markdown-tables` to its latest version.","message":"While generally compatible, ensure `sphinx-markdown-tables` is compatible with your specific Sphinx version, especially when using pre-release or very new Sphinx versions. Major Sphinx upgrades can sometimes introduce changes that affect extensions.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Adhere to the GFM table syntax in your Markdown files for correct rendering. Example: `| H1 | H2 |\\n|----|----|\\n| C1 | C2 |`","message":"`sphinx-markdown-tables` specifically supports GitHub Flavored Markdown (GFM) table syntax. Other Markdown table syntaxes (e.g., reStructuredText's `.. list-table::`) are not supported through this extension for Markdown files.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Check your `conf.py` file to ensure `sphinx_markdown_tables` is present and correctly spelled within the `extensions = [...]` list.","cause":"The `sphinx_markdown_tables` string was not correctly added to the `extensions` list in `conf.py`, or there's a typo in the extension name.","error":"Unknown extension: 'sphinx_markdown_tables'"},{"fix":"1. Verify `sphinx_markdown_tables` is in `extensions` in `conf.py`. 2. If using Markdown files (`.md`), ensure a Markdown parser like `myst_parser` is installed (`pip install myst-parser`) and also added to `extensions` in `conf.py`, and `source_suffix` is configured for `.md`.","cause":"Either `sphinx_markdown_tables` is not enabled, or more commonly, Sphinx isn't configured to parse `.md` files at all (e.g., `myst_parser` is missing or not configured).","error":"Markdown tables not rendering or appearing as raw text in the output HTML/PDF."},{"fix":"Install the package using `pip install sphinx-markdown-tables`. Ensure you are running Sphinx in the correct virtual environment if applicable.","cause":"The `sphinx-markdown-tables` package is not installed in the Python environment where Sphinx is being run to build your documentation.","error":"ModuleNotFoundError: No module named 'sphinx_markdown_tables'"}]}