What Is the Markdown To AsciiDoc Table Converter?

The Markdown To AsciiDoc Table Converter on A.Tools transforms Markdown pipe-delimited tables into AsciiDoc table markup. Four settings let you control formatting, header and footer rows, and table title. All processing runs in your browser. No data leaves your device.

AsciiDoc is a rich text markup language used for technical documentation, books, and man pages. It powers documentation pipelines for projects like Spring Boot, Neo4j, GitLab, and the Fedora Project through tools like Asciidoctor and Antora. AsciiDoc tables use |=== delimiters and | cell separators — a different syntax from Markdown's pipe tables.

How to Convert Markdown Tables to AsciiDoc?

Step 1: Provide Your Markdown Data

Click Enter Data to paste a Markdown table into the input area, or click Choose File to drag and drop a .md file. Press Sample to load example data.

Step 2: Edit in the Online Table Editor

Once parsed, an interactive spreadsheet appears. Use the toolbar to:

• Add or delete rows and columns

• Transpose the table (swap rows and columns)

• Remove duplicate rows

• Delete empty rows and columns

• Change text case (UPPERCASE, lowercase, Capitalize)

• Find and replace values — supports case-sensitive search and regex

• Toggle First Row as Header to define field names

Right-click any cell for context-menu operations.

Step 3: Configure Settings

In the Properties panel:

Step 4: Export

Click Convert to generate AsciiDoc markup. Use Copy to Clipboard or Download File to save the result.

Key Features

• Two input modes: Paste Markdown directly or upload a .md file via drag-and-drop

• Full table editor: Edit, transpose, deduplicate, find-and-replace before converting

• Header and footer rows: Mark the first row as a header and the last row as a footer

• Table title: Add a visible title above the table using . prefix syntax

• Minified format: Remove extra whitespace for compact AsciiDoc output

• Client-side processing: Files never leave the browser — zero data upload

• Undo/Redo: Full edit history with revert support

• Context menu: Right-click for quick row/column/cell operations

• Header toggle: Treat the first row as field names or regular data

• Validation indicator: Real-time feedback on input validity

What the Output Looks Like

Given this Markdown input:

| Name  | Age | City        |
|-------|-----|-------------|
| Alice | 30  | New York    |
| Bob   | 25  | Los Angeles |

Default output (all settings off)

|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | Los Angeles
|===

With First Header enabled

|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | Los Angeles
|===

When First Header is enabled, the first row is marked as a header row and rendered with distinct styling (typically bold and centered) by Asciidoctor.

With Last Footer enabled

The last row is designated as a footer and rendered with distinct styling:

|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | Los Angeles
|===

Footer rows appear at the bottom of the table and are styled differently — often used for totals, summaries, or aggregated values.

With Table Title set to "Employee Directory"

.Employee Directory
|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | Los Angeles
|===

The .Title syntax places a visible caption above the rendered table.

With Minify Format enabled

|===
|Name|Age|City
|Alice|30|New York
|Bob|25|Los Angeles
|===

Whitespace is removed between cells for a compact representation.

All settings combined

.Employee Directory
|===
|Name|Age|City

|Alice|30|New York

|Bob|25|Los Angeles
|===

Understanding AsciiDoc Table Syntax

AsciiDoc vs Markdown tables

Basic AsciiDoc table structure

|===
| Column 1 | Column 2 | Column 3

| Row 1    | Row 1    | Row 1
| Row 2    | Row 2    | Row 2
| Row 3    | Row 3    | Row 3
|===

Key rules:

1. Tables open and close with |=== on their own line

2. Each row starts on a new line with |

3. Cells within a row are separated by |

4. A blank line separates the header row from body rows

5. The table title uses . prefix before the |=== opener

Where AsciiDoc is used

Official reference: Asciidoctor Tables Documentation

Settings Explained

Minify Format

Removes extra whitespace between cells and rows, producing a more compact AsciiDoc table. The minified format is functionally identical to the formatted version but uses less horizontal space.

Formatted output:

|===
| Name     | Age | City
| Alice    | 30  | New York
|===

Minified output:

|===
|Name|Age|City
|Alice|30|New York
|===

Use minified format when embedding tables in tight spaces or when whitespace is unnecessary.

First Header

Designates the first row of the table as a header row. Header rows are rendered with distinct styling by Asciidoctor — typically bold, centered, and with a different background color.

Enable this when the first row contains column labels (names, ages, cities) rather than data.

Last Footer

Designates the last row of the table as a footer row. Footer rows are rendered with distinct styling and visually separated from the body rows.

Common uses:

• Totals row in financial or numeric tables

• Summary row with aggregated values

• Notes row with additional context

Example:

|===
| Product | Q1 | Q2 | Q3 | Q4

| Widget A | 1200 | 1500 | 1300 | 1800
| Widget B | 900 | 1100 | 1000 | 1400

| Total | 2100 | 2600 | 2300 | 3200
|===

Table Title

Adds a visible title (caption) above the rendered table using AsciiDoc's . prefix syntax:

.My Table Title|===| ...|===

The title appears above the table in the rendered output. Use it to:

• Describe the table's contents for readers

• Provide context before the data

• Number tables in long documents (e.g., "Table 1. Revenue by Region")

Use Cases: When to Convert Markdown to AsciiDoc Tables

Asciidoctor HTML Rendering

asciidoctor document.adoc

Produces document.html with styled tables.

Asciidoctor PDF Generation

asciidoctor-pdf document.adoc

Produces document.pdf with professional table formatting.

Antora Integration

In an Antora component descriptor (antora.yml):

name: my-docsversion: '1.0'nav:  - modules/ROOT/nav.adoc

AsciiDoc tables in .adoc pages are rendered automatically by the Antora site generator.

Spring Boot Documentation Style

[[configuration-properties]]
== Configuration Properties

.Configuration properties for the data source
|===
| Property | Default | Description

| `spring.datasource.url` | _none_ | JDBC URL of the database
| `spring.datasource.username` | _none_ | Login username
| `spring.datasource.password` | _none_ | Login password

| Note | | Set these before running the application
|===

Frequently Asked Questions (FAQ)

• Does this tool upload my files to a server?

  No. All file parsing and conversion runs in your browser using JavaScript. Your data stays on your device. A.Tools never receives, stores, or transmits your file contents.

• What Markdown table formats are supported?

  The tool supports standard pipe-delimited Markdown tables following the CommonMark specification, including tables with or without leading/trailing pipes and alignment indicators.

• What is AsciiDoc?

  AsciiDoc is a lightweight markup language designed for writing technical documentation, books, and articles. It is processed by tools like Asciidoctor and Antora to produce HTML, PDF, DocBook, and man page output. AsciiDoc offers richer table features than Markdown, including footers, titles, column spans, and per-cell formatting.

• What is the difference between First Header and Last Footer?

  First Header marks the first row as a header — rendered with bold, centered styling by Asciidoctor. Last Footer marks the last row as a footer — rendered with distinct styling, typically used for totals or summaries.

• What does the Table Title setting do?

  It adds a .Title line before the table opening |===. This creates a visible caption above the rendered table. For example, .Employee Directory displays "Employee Directory" as the table caption.

• Can I use AsciiDoc tables on GitHub?

  Yes. GitHub natively renders .adoc files, including tables. Push an AsciiDoc file to any repository and GitHub will display the rendered table in the file viewer.

• What is Asciidoctor?

  Asciidoctor is the reference implementation of the AsciiDoc language. It is a Ruby-based tool (with a Java wrapper called AsciidoctorJ) that converts AsciiDoc source files into HTML, PDF, DocBook, EPUB, and man page formats. It is used by Antora, GitHub, and many documentation pipelines.

• Can I edit the table before converting?

  Yes. After parsing, the full table editor lets you modify cells, add or remove rows and columns, transpose, deduplicate, change text case, and find-and-replace values.