Convert Excel to reStructuredText Online

Drop an Excel file below, check the table it reads, and get reStructuredText back. The file is read in your browser, so the document stays on your machine, and you can edit the table before you export.

From

The only part of this site that uses a server. The address is sent to it so the page can be fetched, because a browser is not allowed to fetch someone else's page itself. Your own files are never involved.

Nothing here is uploaded. The parsing happens on this page.
Edit
Paste or upload something above and it will appear here.
ToDataMarkupDocumentsCodeSchemasImages

The output will appear here once there is a table to convert.

What Excel is

An Excel workbook is a zip archive of XML parts describing sheets, cells, formulas, styles and charts. The .xlsx extension is that format; .xls is the older binary one from before 2007.

Finance, operations and anyone who received a file from finance or operations.

What reStructuredText is

reStructuredText simple tables underline the header with equals signs and align columns with spaces.

Python documentation, Sphinx projects and anything on Read the Docs.

What changes when you convert Excel to reStructuredText

Only the first sheet is read, and cells are read as the text Excel displays rather than the number underneath. That matters for dates: a cell showing 15/03/2026 arrives as that string, not as a serial number you would then have to decode.

The equals-sign rule under the header is what tells Sphinx the first row is a header. Without it the table renders as data with no heading.

What carries over from Excel to reStructuredText

Excel records 3 things about a table that reStructuredText has no way to hold.

Excel distinguishes a number from the text of a number; reStructuredText does not, so every value arrives as text and has to be re-parsed by whatever reads it next.

An empty cell and a missing one are the same thing in reStructuredText, so a null and an empty string in the Excel both come out blank and can no longer be told apart.

reStructuredText marks its header cells differently from its data cells, so the first row is written with that marker.

Anything visual in the Excel - weight, alignment, colour, column widths - has no counterpart in reStructuredText and is dropped. The values are what survives.

A worked example

Three rows of staff data, with an identifier that has a leading zero, a value containing a comma, a value containing quotes and one blank cell. Those are the four places formats disagree, so they are the four places to look.

The sheet's three rows, as the reader sees them
id,name,role,started,hours
007,Halima Yusuf,"Analyst, data",2024-03-15,38.5
012,"Jonah ""Jo"" Pryce",Engineer,2025-11-02,
104,Wei Chen,Manager,2023-06-30,40
reStructuredText out
===  ================  =============  ==========  =====
id   name              role           started     hours
===  ================  =============  ==========  =====
007  Halima Yusuf      Analyst, data  2024-03-15  38.5
012  Jonah "Jo" Pryce  Engineer       2025-11-02
104  Wei Chen          Manager        2023-06-30  40
===  ================  =============  ==========  =====

Questions

How do I convert Excel to reStructuredText?

Drop your Excel file onto the box above. Check the table in the grid, then copy or download the reStructuredText from the output panel. It takes one step and the file never leaves your browser.

Does reading an Excel file keep my formulas?

No. Each cell arrives as the value Excel was displaying, not the formula behind it. That is usually what you want for a conversion, but it means a sheet full of references becomes a sheet full of results, and anything that depended on recalculating is gone.

Will my numbers still be numbers?

They will read the same, but reStructuredText stores them as text. Anything that sorts or sums the result will need to parse them first, and a leading zero or a currency symbol is the usual place that goes wrong.

Is there a limit on file size?

No. The work happens on your own machine, so the limit is your machine's memory rather than an upload cap. A file with tens of thousands of rows converts in a second or two.

Is my data uploaded anywhere?

No. The parsing and generating are done by JavaScript running on this page. You can watch the network tab while you convert and see that nothing is sent.

Advertisement

Related conversions