AsciiDoc Tables Generator
How to use the AsciiDoc tables generator?
- 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.
- 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.
- 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.