↧ Expand ↧↥ Collapse ↥
Result (updated automatically as you edit the table)
Copy to clipboard

AsciiDoc Tables Generator

How to use the AsciiDoc tables generator?

  1. Enter the data. Copy cells from a spreadsheet (Excel, Google Sheets, LibreOffice Calc) or a table on a web page, click a cell and press Ctrl+V: the table grows to fit them. Or click a cell and type: typing replaces its text, while a double click or Enter edits the text that is there (Esc or a click elsewhere ends the edit). Tab and the arrow keys move to the next cell. Add and remove rows and columns with the Row and Column menus, or by right-clicking a cell. You can also import an Excel workbook or a CSV file with File / Import CSV or Excel file.
  2. Merge cells and adjust text alignment and borders using the options from the menu and the toolbar buttons -- formatting is applied to all the selected cells. Drag the right edge of a column's header to change the column's width.
  3. The table's AsciiDoc code appears under the editor as you edit -- copy it to your document.

What does the generated code look like?

The table is a |=== block. Its cols attribute gives each column the alignment most of its cells have and, when you have set column widths, their proportions. A merged cell starts with its spans, e.g. 2.3+| for a cell two columns wide and three rows high, and a cell aligned differently from its column with its alignment, e.g. ^.^|. With a caption the table gets a title (.Title) and an id, which you can refer to with <<tab:my-table>>.

AsciiDoc draws a table's borders as its frame (the outer borders) and grid (the borders between rows and columns), not per cell: the generator picks the frame and grid that most of the table's borders follow.

Text that AsciiDoc would read as markup, such as *, _, # or {name}, is put in a passthrough so that it prints as typed. To write AsciiDoc markup in the cells, e.g. link:https://example.com[a link], choose Cell text: AsciiDoc markup in the output options under the result.