What Is AsciiDoc?

AsciiDoc is a lightweight markup language for writing documentation, articles, books, and technical content. It uses plain-text formatting conventions similar to Markdown but provides significantly more power and structure. AsciiDoc is the foundation of major documentation ecosystems:  

• Antora — The multi-repository documentation site generator for AsciiDoc, used by Spring Boot, Fedora, and Red Hat.

• Asciidoctor — The reference AsciiDoc processor that renders AsciiDoc to HTML5, DocBook, PDF, and EPUB3.

• GitHub and GitLab — Both platforms natively render .adoc files in repositories.

The official AsciiDoc language specification is available at docs.asciidoctor.org.  

AsciiDoc Table Syntax Reference

AsciiDoc tables use pipe (|) delimiters and are enclosed between |=== borders:  

.Product Catalog

|===

| Name | Price | In Stock

| Widget A | $29.99 | Yes

| Widget B | $49.99 | No

! Total | 2 | !

|===

Key syntax elements:

AsciiDoc vs Markdown for Tables

What Is Excel to AsciiDoc Table?

Excel to AsciiDoc Table is a free online tool that converts spreadsheet data from Excel files (.xlsx, .xls, .xlsm) into AsciiDoc pipe-delimited table syntax. Configure header rows, footer rows, table title, and minified formatting. The tool processes everything in your browser — your files are never uploaded to any server.  

Core Features

• First Header — Treat the first row as the table header, rendered automatically by AsciiDoc processors.

• Last Footer — Treat the last row as a table footer using AsciiDoc's ! footer syntax.

• Table Title — Add an optional .Title caption above the table using AsciiDoc block title syntax.

• Minify Format — Remove blank separator lines between header, body, and footer for compact output.

• Multi-Sheet Support — Select which worksheet to convert from multi-sheet workbooks.

• Built-in Table Editor — Edit cells, transpose, deduplicate, and transform data before conversion.

• First Row as Header — Toggle to use the first row as field names or generic column letters.

• Copy and Download — Copy the AsciiDoc output to clipboard or download as a .adoc file.

• 100% Client-Side Processing — No data leaves your device.

How to Use Excel to AsciiDoc Table

Step 1: Upload or Enter Your Data

Drag and drop an Excel file (.xlsx, .xls, or .xlsm) onto the upload area, or click to browse. Alternatively, click Enter Data to type table data manually.  

Step 2: Edit Your Data (Optional)

After loading, your data appears in an editable table. Use the toolbar to modify cells, add or remove rows and columns, transpose data, remove duplicates and empty rows, change text case, or find and replace values. Toggle First Row as Header to define column names.  

Step 3: Configure AsciiDoc Options

In the Properties panel on the right:  

• Minify Format — Enable to remove blank separator lines between header, body, and footer rows. Disable for readable, well-spaced output.

• First Header — Enable (default) to treat the first data row as the table header. Disable if all rows are body data.

• Last Footer — Enable to treat the last data row as a table footer using ! prefix syntax. Useful for summary rows.

• Table Title — Enter an optional title (e.g., Product Catalog). Output: .Product Catalog above the table.

Conversion Example

Given this Excel table:

With First Header on, Last Footer on, and Table Title set to "Product Catalog":

.Product Catalog

|===

| Name | Price | In Stock

| Widget A | $29.99 | Yes

| Widget B | $49.99 | No

! Total | 2 items | —

|===

Step 4: Copy or Download

Click Copy to Clipboard to copy the AsciiDoc output into your documentation project. For file download, use the Download button (requires Premium Plan). The file is saved with a .adoc extension.  

Common Use Cases

• Technical Documentation — Convert specification data from Excel into AsciiDoc tables for software documentation projects.

• Antora Component Docs — Generate .adoc tables for Antora-managed documentation sites.

• API Reference Tables — Convert API parameter spreadsheets into AsciiDoc tables for REST API documentation.

• Configuration Reference — Transform configuration property lists from Excel into formatted AsciiDoc tables.

• Release Notes — Convert changelog spreadsheets into AsciiDoc tables for version release notes.

• Open Source Projects — Many open source projects (Spring, Fedora, Neo4j) use AsciiDoc for docs — convert spreadsheet data into their format.

• Migration from Markdown — When migrating from Markdown-based docs to AsciiDoc, convert existing data tables.

Frequently Asked Questions (FAQ)

• Is my Excel data uploaded to a server?

  No. All file parsing and AsciiDoc table generation happens entirely in your browser using client-side JavaScript. Your files are never uploaded, transferred, or stored on any server. The tool works offline once the page has loaded.

• What Excel file formats are supported?

  The tool supports .xlsx (Excel 2007+), .xls (Excel 97-2003), and .xlsm (macro-enabled) files. Multi-sheet workbooks are supported — use the sheet selector to choose which sheet to convert.

• What is the difference between First Header and First Row as Header?

  First Row as Header (in the editor toolbar) controls whether the first row of your spreadsheet is treated as column names in the editor. First Header (in the Properties panel) controls whether that first row appears as a header row in the AsciiDoc output. For standard tables, enable both. For data-only tables (no header), disable both.

• How does the Last Footer option work?

  When Last Footer is enabled, the last row of your data is formatted as an AsciiDoc table footer using the ! prefix syntax. The footer row is separated from the body by a blank line (or no blank line if Minify is enabled). This is useful for summary rows, totals, or aggregation data.

• What does Minify Format do?

  Minify Format removes the blank separator lines between the header, body, and footer sections. With minify off, the output includes empty lines for readability. With minify on, the output is more compact. Both formats are valid AsciiDoc — the blank lines are optional visual separators.

• What is the .adoc file extension?

  .adoc is the standard file extension for AsciiDoc documents. AsciiDoc processors like Asciidoctor and Antora recognize .adoc files and render them to HTML, PDF, or other output formats. The tool saves downloaded files with the .adoc extension.

• Can I edit the data before converting?

  Yes. After uploading your file, the built-in table editor lets you modify cell values, add or remove rows and columns, transpose data, remove duplicates and empty rows, change text case, and find-and-replace — all before generating the AsciiDoc table.

• How do I use the output with Antora or Asciidoctor?

  Copy the generated AsciiDoc table and paste it into any .adoc file in your Antora component or Asciidoctor project. The output uses standard AsciiDoc table syntax that is fully compatible with both tools. For Antora, place the file in the modules/ROOT/pages/ directory of your component.

• What is the difference between AsciiDoc and Markdown?

  AsciiDoc is a more feature-rich markup language than Markdown, with native support for table headers and footers, cell spanning, column alignment, nested tables, and conditional content. Markdown is simpler and more widely adopted, but its table syntax is limited to basic pipe-delimited tables with a single header row. AsciiDoc is preferred for large-scale technical documentation projects (Red Hat, Spring, Neo4j), while Markdown is common for READMEs, blogs, and lightweight docs.

• Can I use this tool without uploading a file?

  Yes. Click the Enter Data button to open a blank editor where you can type or paste table data manually, then generate the AsciiDoc table.