JSON to reStructuredText Table — Free Online RST Table Generator

What Is reStructuredText (reST)?

reStructuredText (reST) is a lightweight text markup language designed for technical documentation. Created by David Goodger as part of the docutils project, reST is the standard markup language for:

reST supports two table syntaxes for representing tabular data: grid tables and simple tables.

What Is JSON?

JSON (JavaScript Object Notation) is a lightweight data-interchange format defined by RFC 8259. It represents structured data as arrays and key-value objects. APIs, databases, and configuration files output JSON.

reStructuredText Table Syntax Reference

Grid Tables

Grid tables use a full set of ASCII drawing characters to create borders, column separators, and row separators.

+------------+------+--------------------+
| language   | year | creator            |
+============+======+====================+
| Python     | 1991 | Guido van Rossum   |
+------------+------+--------------------+
| JavaScript | 1995 | Brendan Eich       |
+------------+------+--------------------+
| Go         | 2009 | Robert Griesemer   |
+------------+------+--------------------+

Characters used: + (corners/intersections), - (horizontal), = (header separator), | (vertical).

Simple Tables

Simple tables use = characters for top/bottom borders and header separators. No vertical bars or + intersections.

============  ======  ====================
language      year    creator
============  ======  ====================
Python        1991    Guido van Rossum
JavaScript    1995    Brendan Eich
Go            2009    Robert Griesemer
============  ======  ====================

Characters used: = only. Column width is determined by the widest cell in each column.

Grid vs. Simple — When to Use Each

Why Convert JSON to a reStructuredText Table?

Core Features

1. Dual Input Modes

• File Upload: Drag and drop or select a .json file.

• Code Editor: Paste or type raw JSON with syntax highlighting and real-time validation.

2. Border Style Selection

3. Text Alignment

Control how text is aligned within table cells:

4. Row Separators

When enabled, the tool adds separator lines between every data row (not just between header and body). This creates a fully gridded table where each cell is visually distinct.

Row Separators Off (Grid):

+----------+--------+
| name     | role   |
+==========+========+
| Alice    | Eng    |
| Bob      | Design |
+----------+--------+

Row Separators On (Grid):

+----------+--------+
| name     | role   |
+==========+========+
| Alice    | Eng    |
+----------+--------+
| Bob      | Design |
+----------+--------+

5. Privacy by Design

All processing runs entirely in your browser. No data is uploaded to any server.

How to Use This JSON to reStructuredText Table Converter?

Step 1: Provide Your JSON Data

Choose one of two input methods:

• Upload a file: Click "Choose File" and select a .json file, or drag it into the upload area.

• Paste data: Click "Enter Data" to switch to the code editor. Paste your JSON array. A green "Valid JSON" badge confirms correct formatting.

Step 2: Configure Output Options

Use the Properties panel on the right:

1. Border Style: Select "reStructuredText Grid" or "reStructuredText Simple".

2. Text Alignment: Choose Left, Center, or Right.

3. Row Separators: Toggle on to add separator lines between every data row.

Step 3: Convert

Click Convert. The reStructuredText table output appears in the "Output Data" panel.

Step 4: Copy or Download

• Click Copy to Clipboard to paste into your .rst file.

• Premium users can click Download File to save the output.

Samples

Sample Input

[
 {"language": "Python", "year": 1991, "creator": "Guido van Rossum"},
 {"language": "JavaScript", "year": 1995, "creator": "Brendan Eich"},
 {"language": "Go", "year": 2009, "creator": "Robert Griesemer"}
]

Sample Output — Grid Table

+------------+------+--------------------+
| language   | year | creator            |
+============+======+====================+
| Python     | 1991 | Guido van Rossum   |
+------------+------+--------------------+
| JavaScript | 1995 | Brendan Eich       |
+------------+------+--------------------+
| Go         | 2009 | Robert Griesemer   |
+------------+------+--------------------+

Sample Output — Simple Table

============  ======  ====================
language      year    creator
============  ======  ====================
Python        1991    Guido van Rossum
JavaScript    1995    Brendan Eich
Go            2009    Robert Griesemer
============  ======  ====================

Sample Output — Grid with Row Separators and Center Alignment

+------------+------+--------------------+
|  language  | year |      creator       |
+============+======+====================+
|   Python   | 1991 |  Guido van Rossum  |
+------------+------+--------------------+
| JavaScript | 1995 |   Brendan Eich     |
+------------+------+--------------------+
|     Go     | 2009 | Robert Griesemer   |
+------------+------+--------------------+

Supported JSON Input Formats

• JSON arrays of objects (most common): [{"key": "value"}, ...]

• JSON arrays of arrays: [["value1", "value2"], ...]

• Nested JSON objects (flattened to dot-notation keys)

Frequently Asked Questions (FAQ)

• Does the tool upload my data?

  No. All conversion happens locally in your browser using JavaScript. Your data never leaves your device.

• What is reStructuredText?

  reStructuredText (reST) is a lightweight markup language for technical documentation. It is the standard markup for Sphinx, the Python documentation generator, and is used by Python Enhancement Proposals (PEPs), Read the Docs, and thousands of open-source projects.

• What is the difference between grid and simple tables?

  Grid tables use +, -, =, and | characters to draw full borders around every cell. They support column spans, row spans, and nested tables. Simple tables use only = characters for top/bottom borders and header separators — they are easier to write but do not support spanning or nesting.

• Can I use the output in Sphinx?

  Yes. Both grid and simple table formats are fully supported by Sphinx and docutils. Paste the generated table directly into any .rst file.

• What does the Row Separators option do?

  When enabled, it adds separator lines between every data row in grid tables, making each cell visually distinct. Without it, only the header separator (===) is shown.

• What text alignment options are available?

  Left (default), Center, and Right. Alignment is applied by padding cell content with spaces.

• Can I convert JSON to RST on mobile?

  Yes. The tool is responsive and works on smartphones and tablets.

• Is there a file size limit?

  The tool processes data entirely in your browser. Files up to 10 MB typically convert without issues on modern hardware.

• How do grid tables compare to Markdown tables in Sphinx?

  reST grid tables support column spans, row spans, and nested tables — Markdown tables do not. For complex documentation, grid tables are more capable. For simple data, both work equivalently.