Convert Excel to AsciiDoc Online

Drop an Excel file below, check the table it reads, and get AsciiDoc 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 AsciiDoc is

AsciiDoc tables are delimited by |=== and take a cols attribute describing the columns.

Antora documentation sites, and technical writing teams that outgrew Markdown.

What changes when you convert Excel to AsciiDoc

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 header option is set so the first row renders as a header row rather than data.

What carries over from Excel to AsciiDoc

Excel records 2 things about a table that AsciiDoc has no way to hold.

Excel distinguishes a number from the text of a number; AsciiDoc 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 AsciiDoc, so a null and an empty string in the Excel both come out blank and can no longer be told apart.

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

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
AsciiDoc out
[cols="1,1,1,1,1",options="header"]
|===
| 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 AsciiDoc?

Drop your Excel file onto the box above. Check the table in the grid, then copy or download the AsciiDoc 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 AsciiDoc 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