CSV to reStructuredText Table — Free Online RST Table Generator

What Is reStructuredText?

reStructuredText (reST, RST) is a plaintext markup language and part of the Python Docutils project. It is the default markup for Sphinx, the documentation generator used by Python, Django, and thousands of open-source projects.

Where reStructuredText Is Used

reStructuredText Table Formats

reST supports two table formats:

Grid Tables

Full ASCII-art borders with +, -, and |:

+----------+-----+----------+

| Name     | Age | City     |

+==========+=====+==========+

| Alice    |  30 | New York |

+----------+-----+----------+

| Bob      |  25 | London   |

+----------+-----+----------+

Simple Tables

Minimal borders using = and -:

=====  =====  ======

Name   Age    City

=====  =====  ======

Alice    30   New York

Bob      25   London

=====  =====  ======

Grid vs. Simple Tables

Why Convert CSV to reStructuredText Tables?

Core Features

1. Online Table Editor

After loading CSV data, an interactive spreadsheet grid lets you edit before converting:

2. Row Separators

Adds separator lines between each data row in grid tables. Only applies to grid table format.

Without row separators:

+----------+-----+----------+

| Name     | Age | City     |

+==========+=====+==========+

| Alice    |  30 | New York |

| Bob      |  25 | London   |

| Charlie  |  35 | Tokyo    |

+----------+-----+----------+

With row separators:

+----------+-----+----------+

| Name     | Age | City     |

+==========+=====+==========+

| Alice    |  30 | New York |

+----------+-----+----------+

| Bob      |  25 | London   |

+----------+-----+----------+

| Charlie  |  35 | Tokyo    |

+----------+-----+----------+

Row separators improve readability for large tables with many columns. They add visual structure but increase vertical size.

3. Border Style

Controls the border format of the output table:

4. Text Alignment

Controls how text is aligned within table columns:

5. Privacy by Design

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

How to Use This Tool — Step-by-Step

Step 1: Load CSV Data

Choose one of two input methods:

• Upload a file: Click "Choose File" and select a .csv file.

• Paste data: Click "Enter Data" to switch to the code editor. Paste your CSV.

Step 2: Edit in Table Editor (Optional)

Use the toolbar to clean your data before converting.

Step 3: Configure Output

Use the Properties panel:

1. Row Separators: Enable for grid tables with per-row borders.

2. Border Style: Choose Grid or Simple table format.

3. Text Alignment: Choose left, center, or right alignment.

Step 4: Convert

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

Step 5: Copy or Download

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

• Premium users can click Download File to save.

Complete Example

Example — Grid Table

Input CSV:

method,accuracy,f1,latency_ms

Baseline,0.82,0.79,12

Model A,0.91,0.89,45

Model B,0.94,0.93,120

Ours,0.97,0.96,38

Configuration:

• Border Style: Grid

• Row Separators: Off

• Text Alignment: Left

Output:

+----------+------------+------+-------------+

| method   |   accuracy |   f1 |   latency_ms |

+==========+============+======+=============+

| Baseline |       0.82 | 0.79 |          12 |

| Model A  |       0.91 | 0.89 |          45 |

| Model B  |       0.94 | 0.93 |         120 |

| Ours     |       0.97 | 0.96 |          38 |

+----------+------------+------+-------------+

Example — Simple Table

Same input CSV.

Configuration: Border Style: Simple

Output:

=========  =========  ====  ===========

method     accuracy   f1    latency_ms

=========  =========  ====  ===========

Baseline        0.82  0.79           12

Model A         0.91  0.89           45

Model B         0.94  0.93          120

Ours            0.97  0.96           38

=========  =========  ====  ===========

Example — Grid Table with Row Separators

Input CSV:

parameter,type,required,description

query,string,true,Search query text

limit,integer,false,Max results to return

offset,integer,false,Number of results to skip

sort,string,false,Sort field and direction

Configuration: Border Style: Grid, Row Separators: On

Output:

+-------------+----------+------------+--------------------------+

| parameter   | type     | required   | description              |

+=============+==========+============+==========================+

| query       | string   | true       | Search query text        |

+-------------+----------+------------+--------------------------+

| limit       | integer  | false      | Max results to return    |

+-------------+----------+------------+--------------------------+

| offset      | integer  | false      | Number of results to skip |

+-------------+----------+------------+--------------------------+

| sort        | string   | false      | Sort field and direction |

+-------------+----------+------------+--------------------------+

Example — Django Settings Table

Input CSV:

setting,default,description

DEBUG,True,Enable debug mode

ALLOWED_HOSTS,[],List of allowed host strings

DATABASES,{},Database connection settings

INSTALLED_APPS,[],List of installed Django apps

Configuration: Border Style: Simple

Output:

==================  =========  ============================

setting             default    description

==================  =========  ============================

DEBUG               True       Enable debug mode

ALLOWED_HOSTS       []         List of allowed host strings

DATABASES           {}         Database connection settings

INSTALLED_APPS      []         List of installed Django apps

==================  =========  ============================

How to Build reST Documentation with Sphinx

Install Sphinx

pip install sphinx

Create a Sphinx Project

mkdir docs && cd docssphinx-quickstart

Build HTML

make html# Output in _build/html/

Build PDF (via LaTeX)

make latexpdf

Build Single Page

sphinx-build -b html source/ build/

reStructuredText Quick Reference (Beyond Tables)

Frequently Asked Questions (FAQ)

• Does the tool upload my data to the server?

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

• What is reStructuredText?

  reStructuredText (reST/RST) is a plaintext markup language used by Sphinx, the Python documentation generator. It is the standard format for Python docs, Django docs, and many open-source projects.

• What is the difference between Grid and Simple tables?

  Grid tables use full ASCII-art borders (+--+) and support cell spanning. Simple tables use === underlines only — more concise but no spanning. Use Grid for complex tables; use Simple for straightforward data.

• What are Row Separators?

  Row separators add horizontal lines (+--+) between each data row in grid tables. They improve readability but make the output larger. Only applies to grid table format.

• Can I use the output in Sphinx?

  Yes. The output is standard reStructuredText table syntax compatible with Sphinx, Docutils, and Read the Docs. Paste directly into .rst files.

• Can I edit the data before converting?

  Yes. The built-in table editor lets you modify cells, transpose, deduplicate, find/replace, change case, and insert/delete rows and columns.

• What CSV formats are supported?

  Standard CSV with comma delimiters. The first row can be used as column headers (enable "First Row as Header").

• 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.

• Can I use this on mobile?

  Yes. The tool is responsive, though the table editor is best experienced on desktop.