What Is reStructuredText?

reStructuredText (RST) is a lightweight markup language designed for technical documentation. Created by the Python community, it is the native format for Sphinx — the documentation generator used by Python, Django, Flask, NumPy, and thousands of other open-source projects.

RST supports two table formats: Grid tables (full border control with +, -, and | characters) and Simple tables (minimal borders using = and - underlines). Converting Excel data to RST tables lets you embed tabular data directly into Sphinx documentation without manual formatting.

RST Table Syntax at a Glance

Why Convert Excel to reStructuredText Tables?

• Sphinx documentation — Embed product specs, API parameter tables, or configuration reference data directly into your .rst documentation files.

• Python package docs — Convert data catalogs, version histories, or feature comparison matrices from spreadsheets into RST tables for Read the Docs.

• Technical specifications — Move engineering data from Excel into version-controlled RST files that integrate with CI/CD documentation pipelines.

• Avoid manual formatting — RST Grid tables require precise character alignment that is tedious to create by hand, especially for large datasets.

• Consistent alignment — The converter handles column width calculation and alignment characters automatically.

Core Features

• Two table styles — Choose between Grid (full borders) and Simple (header/body underlines only) output formats.

• Text alignment control — Set alignment to Left, Center, or Right for all columns at once.

• Row separators — Optionally insert separator lines between every row in Grid tables for enhanced readability.

• Drag-and-drop upload — Drop any .xlsx, .xls, or .xlsm file onto the upload zone.

• Built-in table editor — Modify cell values, add or delete rows and columns, transpose, deduplicate, and apply case transformations before conversion.

• Multi-sheet support — Switch between worksheets in multi-sheet workbooks via the sheet selector dropdown.

• First Row as Header toggle — Control whether the first row is treated as column headers or regular data.

• Find & Replace — Bulk-replace cell values with optional regex and case-sensitive matching.

• Undo / Redo — Full edit history so you can revert mistakes.

• Copy & Downlaoad — One-click copy of the generated RST table, and you can also download the generated RST table code.

• 100% client-side — Your spreadsheet data never leaves your device. No files are uploaded to any server.

How to Convert Excel to reStructuredText Table

1. Upload your file — Drag an .xlsx, .xls, or .xlsm file onto the upload area, or click Click here to choose to browse.

2. Edit if needed — Use the built-in table editor to modify values, add or remove rows and columns, transpose, deduplicate, or apply case changes.

3. Choose a border style — Select reStructuredText Grid for full borders or reStructuredText Simple for a minimal underline style.

4. Set text alignment — Pick Left, Center, or Right alignment for the output table columns.

5. Toggle row separators — Enable Row Separators to insert horizontal lines between each row (Grid tables only).

6. Click Convert — Press the Convert button. The RST table output appears in the Output Data area.

7. Copy & Downlaoad the result — Click Copy to Clipboard and paste the RST table into your documentation, and you can also download the generated RST table code.

Output Examples

Input spreadsheet (api_params.xlsx):

Grid table output (Row Separators ON, Center alignment):

+-----------+---------+----------+
| Parameter |  Type   | Required |
+===========+=========+==========+
|   name    | string  |   Yes    |
+-----------+---------+----------+
|   page    | integer |    No    |
+-----------+---------+----------+
|   limit   | integer |    No    |
+-----------+---------+----------+

Simple table output (Left alignment):

=====  =======  ========
Parameter   Type    Required
=====  =======  ========
name    string   Yes
page    integer  No
limit   integer  No
=====  =======  ========

reStructuredText Grid vs Simple Tables — When to Use Each

reStructuredText vs Markdown vs AsciiDoc for Tables

Frequently Asked Questions (FAQ)

• What file formats does this tool accept?

  The tool accepts Microsoft Excel files in .xlsx, .xls, and .xlsm formats. LibreOffice and Google Sheets files exported as .xlsx also work.

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

  Grid tables use +, -, and | characters to draw full borders around every cell. They support cell spanning (colspan/rowspan) and row separators. Simple tables use only = (header) and - (body) underlines — no vertical borders. Simple tables are more compact but do not support cell spanning.

• Does the tool upload my Excel file to a server?

  No. All processing happens entirely in your browser using client-side JavaScript. Your file never leaves your device. There are no server uploads, transfers, or storage of any kind.

• How does the Row Separators option work?

  When Row Separators is enabled, horizontal separator lines (+---+---+) are inserted between every data row in Grid tables. This option has no effect on Simple tables. Row separators improve readability in dense tables with many rows.

• How does text alignment work in the output?

  In Grid tables, alignment is indicated by colon placement in the separator row: :--- for left, :---: for center, and ---: for right. In Simple tables, alignment is determined by the position of the underline text relative to the column width. The converter applies your chosen alignment to all columns uniformly.

• Can I edit the data before converting?

  Yes. After uploading, a full table editor appears. You can modify individual cells, add or delete rows and columns, transpose, deduplicate, apply case transformations (UPPERCASE, lowercase, Capitalize), and perform find-and-replace operations.

• Does the tool support multi-sheet Excel files?

  Yes. When your workbook contains multiple sheets, a dropdown selector appears in the editor header. Choose the sheet you want to convert.

• Is there a file size limit?

  Since processing is entirely client-side, the limit depends on your browser's memory. Most modern browsers handle workbooks with tens of thousands of rows without issues. For very large tables, Grid output can become wide — consider Simple tables for a more compact result.