What Is the Markdown To reStructuredText Table Converter?

The Markdown To reStructuredText Table Converter on A.Tools transforms Markdown pipe-delimited tables into reStructuredText (RST) table syntax — the documentation format used by Python's Sphinx, Read the Docs, and docutils. All processing runs in your browser. No data leaves your device.

Developers write Markdown tables in GitHub README files. Python projects use reStructuredText for documentation hosted on Read the Docs. This tool converts between the two formats in seconds.

How to Convert Markdown Tables to reStructuredText?

Step 1: Provide Your Markdown Data

Click Enter Data to paste a Markdown table into the input area, or click Choose File to drag and drop a .md file. Press Sample to load example data.

Step 2: Edit in the Online Table Editor

Once parsed, an interactive spreadsheet appears. Use the toolbar to:

• Add or delete rows and columns

• Transpose the table (swap rows and columns)

• Remove duplicate rows

• Delete empty rows and columns

• Change text case (UPPERCASE, lowercase, Capitalize)

• Find and replace values — supports case-sensitive search and regex

• Toggle First Row as Header to define column names

Right-click any cell for context-menu operations.

Step 3: Configure RST Output

In the Properties panel:

Step 4: Export

Click Convert to generate RST output. Use Copy to Clipboard or Download File to save.

Key Features

• Two input modes: Paste Markdown directly or upload a .md file via drag-and-drop

• Full table editor: Edit, transpose, deduplicate, find-and-replace before converting

• Two RST border styles: Grid tables and Simple tables

• Text alignment: Left, center, or right column alignment

• Row separators: Optional separator lines between data rows

• Client-side processing: Files never leave the browser — zero data upload

• Undo/Redo: Full edit history with revert support

• Context menu: Right-click for quick row/column/cell operations

• Header toggle: Treat the first row as a header or regular data

What Is reStructuredText?

reStructuredText (RST) is a lightweight markup language designed for technical documentation. It is the default format for:

• Sphinx — the Python documentation generator used by docs.python.org, NumPy, SciPy, and thousands of Python packages

• Read the Docs — the documentation hosting platform

• PEP documents — Python Enhancement Proposals

• docutils — the reference RST parser

RST is maintained by the docutils project. The table specification is documented at docutils RST reference.

RST Table Syntax Reference: Grid vs. Simple

Grid Tables

Grid tables use +, -, |, and = characters to draw complete borders:

+------+-----+-------------+
| Name | Age | City        |
+======+=====+=============+
| Alice| 30  | New York    |
+------+-----+-------------+
| Bob  | 25  | Los Angeles |
+------+-----+-------------+

Grid tables support:

• Cell spanning (rows and columns)

• Arbitrary column widths

• Row separators between any rows

Use Grid tables when you need cell spanning or when visual clarity matters in the source.

Simple Tables

Simple tables use = and - characters:

=====  =====  ============
Name   Age    City
=====  =====  ============
Alice  30     New York
Bob    25     Los Angeles
=====  =====  ============

Simple tables are:

• More readable in plain text

• Easier to edit manually

• Limited to uniform row heights (no spanning)

Use Simple tables for straightforward data without spanning.

Comparison

RST Output Settings Explained

Border Style

reStructuredText Grid: Draws complete borders with +, -, | characters. Supports cell spanning and row separators between any rows. More verbose but more flexible.

reStructuredText Simple: Uses = for top/bottom borders and header separator. Cleaner source, easier to maintain. Does not support cell spanning.

Text Alignment

Controls the alignment of cell content within columns:

• Left: Content left-aligned (default for most text)

• Center: Content centered

• Right: Content right-aligned (useful for numbers)

In Grid tables, alignment is visual (padding). In Simple tables, alignment is indicated by the position of the = border relative to the column header text.

Row Separators

When enabled, adds a +---+---+ separator line between every data row in Grid tables. This improves readability when rows contain multi-line content.

When disabled, data rows are separated only by | characters without horizontal rules.

Markdown vs. reStructuredText Tables

Markdown tables are simpler but limited. RST tables support spanning, multi-line cells, and richer formatting — at the cost of more verbose syntax.

Frequently Asked Questions (FAQ)

• Does this tool upload my files to a server?

  No. All file parsing and conversion runs in your browser using JavaScript. Your data stays on your device. A.Tools never receives, stores, or transmits your file contents.

• What Markdown table formats are supported?

  The tool supports standard pipe-delimited Markdown tables following the CommonMark specification, including tables with or without leading/trailing pipes and alignment indicators.

• What is the difference between Grid and Simple RST tables?

  Grid tables use +, -, | characters to draw complete borders and support cell spanning. Simple tables use = and - for borders, are more readable, but do not support cell spanning.

• Is the output compatible with Sphinx?

  Yes. Both Grid and Simple table outputs follow the reStructuredText specification and are fully compatible with Sphinx, Read the Docs, and docutils.

• Can I edit the table before converting?

  Yes. After parsing, the full table editor lets you modify cells, add or remove rows and columns, transpose, deduplicate, change text case, and find-and-replace values.

• What does the Row Separators toggle do?

  When enabled, it adds horizontal separator lines (+---+---+) between every data row in Grid tables. This improves readability for tables with multi-line cell content.

• How does text alignment work in RST tables?

  In Grid tables, alignment is achieved by adjusting whitespace padding within cells. In Simple tables, alignment is inferred from the position of header text relative to the = border.

• Is there a file size limit?

  Processing is client-side, so the limit depends on your browser's memory. Tables with tens of thousands of rows work reliably on modern browsers.