JSON to AsciiDoc Table — Free Online AsciiDoc Table Generator

What Is AsciiDoc?

AsciiDoc is a plain-text markup language for writing technical documentation, articles, books, and man pages. It is designed to be readable as-is and convertible to HTML, PDF, EPUB, and DocBook.

Where AsciiDoc Is Used

AsciiDoc Table Syntax

Basic Table

|===
| Name | Age | City
| Alice | 30 | New York
| Bob | 25 | London
| Charlie | 35 | Tokyo
|===

Table with Header

|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | London
|===

The first row after |=== (followed by a blank line) is treated as the header.

Table Elements

AsciiDoc vs. Markdown vs. reStructuredText

Why Convert JSON to AsciiDoc Tables?

Core Features

1. Dual Input Modes

• File Upload: Drag and drop or select a .json file.

• Code Editor: Paste or type raw JSON with syntax highlighting and real-time validation.

2. Minify Format

Removes extra whitespace for compact output.

Regular format:

|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | London
|===

Minified format:

|===
|Name|Age|City

|Alice|30|New York
|Bob|25|London
|===

Use minified for smaller file sizes. Use regular for readability and editing.

3. First Header

Uses the first data row as the table header. In AsciiDoc, the header row is separated from body rows by a blank line.

Enabled:

|===
| Name | Age | City

| Alice | 30 | New York
| Bob | 25 | London
|===

Disabled:

|===
| Name | Age | City
| Alice | 30 | New York
| Bob | 25 | London
|===

Enable this when your JSON object keys should be column headers (most cases).

4. Last Footer

Treats the last data row as a footer row. In AsciiDoc, footer rows are rendered distinctly.

|===
| Product | Price

| Laptop | $1,299
| Phone | $699

| Total | $1,998
|===

Use this for summary rows, totals, or concluding data.

5. Table Title

Adds a title above the table using AsciiDoc's .Title syntax:

.Employee Salary Report
|===
| Name | Department | Salary

| Alice | Engineering | $95,000
| Bob | Marketing | $78,000
|===

Table titles appear as captions when rendered to HTML or PDF.

6. Privacy by Design

All processing runs entirely in your browser. No data is uploaded to any server.

How to Use This JSON to AsciiDoc Table Generator

Step 1: Provide Your JSON Data

Choose one of two input methods:

• Upload a file: Click "Choose File" and select a .json file, or drag it into the upload area.

• Paste data: Click "Enter Data" to switch to the code editor. Paste your JSON array.

Important: The tool expects a JSON array of objects. Each object becomes a row; keys become columns.

Step 2: Configure Output

Use the Properties panel:

1. Minify Format: Enable for compact output.

2. First Header: Enable to use first row as column headers.

3. Last Footer: Enable to treat last row as footer.

4. Table Title: Enter a title (e.g., "Employee Directory").

Step 3: Convert

Click Convert. The AsciiDoc markup appears in the "Output Data" panel.

Step 4: Copy or Download

• Click Copy to Clipboard to paste into your .adoc file.

• Premium users can click Download File to save.

Complete Example

Example — Full Table with All Options

Input JSON:

[
   {"product": "Laptop", "price": 1299.99, "stock": 45},
   {"product": "Phone", "price": 699.99, "stock": 120},
   {"product": "Tablet", "price": 499.99, "stock": 0},
   {"product": "Total (3 products)", "price": 2499.97, "stock": 165}
]

Configuration:

• Minify Format: Off

• First Header: On

• Last Footer: On

• Table Title: Product Inventory

Output:

.Product Inventory
|===
| product | price | stock

| Laptop | 1299.99 | 45
| Phone | 699.99 | 120

| Total (3 products) | 2499.97 | 165
|===

Example — Minimal Table (No Options)

Input JSON:

[
   {"name": "Alice", "score": 95},
   {"name": "Bob", "score": 88}
]

Configuration: All options off.

Output:

|===
| name | score
| Alice | 95
| Bob | 88
|===

Example — API Parameters Table

Input JSON:

[
   {"parameter": "query", "type": "string", "required": true, "description": "Search query text"},
   {"parameter": "limit", "type": "integer", "required": false, "description": "Max results to return"},
   {"parameter": "offset", "type": "integer", "required": false, "description": "Number of results to skip"},
   {"parameter": "sort", "type": "string", "required": false, "description": "Sort field and direction"}
]

Configuration:

• First Header: On

• Table Title: API Parameters

Output:

.API Parameters
|===
| parameter | type | required | description

| query | string | true | Search query text
| limit | integer | false | Max results to return
| offset | integer | false | Number of results to skip
| sort | string | false | Sort field and direction
|===

AsciiDoc Table Tips

Frequently Asked Questions (FAQ)

• Does the tool upload my data?

  No. All conversion happens locally in your browser using JavaScript. Your data never leaves your device.

• What is AsciiDoc?

  AsciiDoc is a plain-text markup language for writing technical documentation. Files use the .adoc extension and can be converted to HTML, PDF, EPUB, and other formats using Asciidoctor.

• Where can I use AsciiDoc tables?

  Antora documentation sites, GitLab wikis, GitHub repositories (.adoc files), technical manuals, and any project using Asciidoctor or the AsciiDoc toolchain.

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

  First Header treats the first row as a column header (visually distinct). Last Footer treats the last row as a footer (typically used for totals or summaries).

• What does Minify Format do?

  It removes extra whitespace and spaces around pipe characters for a more compact output. Disable for readable output that's easy to edit by hand.

• What input format is required?

  A JSON array of objects: [{"key": "value"}, ...]. Each object becomes one row. Object keys become column headers.

• How do I render the output?

  Use Asciidoctor: asciidoctor document.adoc converts to HTML. Use asciidoctor-pdf document.adoc for PDF output. Or paste into any AsciiDoc-compatible platform (GitLab, Antora).

• Is there a file size limit?

  The tool processes data entirely in your browser. Files up to 10 MB typically convert without issues on modern hardware.

• Can I use this on mobile?

  Yes. The tool is responsive and works on smartphones and tablets.