rst-in-md

rst-in-md is a simple tool to convert reStructuredText within Markdown, built to extend Python Markdown.

• Easy to use, no complex setup required
• Supports many reStructuredText elements
• Integrates with MkDocs
• Integrates with PyMdown Extensions

Turn this:

markdown.md

   ```rst
   +------------------------+------------+----------+----------+
   | Header row, column 1   | Header 2   | Header 3 | Header 4 |
   | (header rows optional) |            |          |          |
   +========================+============+==========+==========+
   | body row 1, column 1   | column 2   | column 3 | column 4 |
   +------------------------+------------+----------+----------+
   | body row 2             | Cells may span columns.          |
   +------------------------+------------+---------------------+
   | body row 3             | Cells may  | - Table cells       |
   +------------------------+ span rows. | - contain           |
   | body row 4             |            | - body elements.    |
   +------------------------+------------+---------------------+
   ```

Into this:

Header row, column 1 (header rows optional)	Header 2	Header 3	Header 4
body row 1, column 1	column 2	column 3	column 4
body row 2	Cells may span columns.
body row 3	Cells may span rows.	Table cells contain body elements.
body row 4

To get started, please head to installation guide.

To understand how this tool works, you can read more about the implementation.