10 Creative ASCII Art Table Designs for Terminals and Text Files

Quick ASCII Art Table Generator: From Simple Grids to Complex Layouts

ASCII art tables are a lightweight, portable way to present structured data in plain text — perfect for README files, terminal output, logs, or any context where plain text is required. This guide shows how to build a quick ASCII table generator, starting with simple grids and progressing to complex layouts with alignment, padding, and optional borders.

1 — Core design decisions

• Cell content: plain text (no markup).
• Column widths: determined by the longest cell in each column or a user-specified width.
• Alignment: left, center, right per column.
• Padding: spaces inside cells (default: 1 on each side).
• Borders: none, single-line (─│┌┐└┘├┤┬┴┼), or simple ASCII (+-+|).
• Wrapping: truncate or wrap long content. Default: truncate.

2 — Simple generator algorithm (conceptual)

1. Read rows as arrays of strings; infer number of columns from the widest row.
2. Normalize rows: fill missing cells with empty strings.
3. Compute column widths: for each column, width = max(length(cell)) + 2*padding, or use specified width.
4. For each row, for each cell:
   • Apply alignment (left/center/right).
   • Pad to column width.
5. Render:
   • Optional top border row.
   • For each row: join cells with vertical separators.
   • Optional separator between header and body.
   • Optional bottom border.

3 — Example output styles

• Minimal (no borders) Name Age City Alice 30 Seattle
• Simple ASCII borders (+-|): +——–+—–+———+ | Name | Age | City | +——–+—–+———+ | Alice | 30 | Seattle | +——–+—–+———+
• Unicode box-drawing: ┌────────┬─────┬─────────┐ │ Name │ Age │ City │ ├────────┼─────┼─────────┤ │ Alice │ 30 │ Seattle │ └────────┴─────┴─────────┘

4 — Handling alignment, padding, and wrapping

• Alignment: compute left padding and right padding:
  • left: left pad = padding, right pad = colWidth – padding – len(cell)
  • center: split remaining spaces evenly
  • right: left pad = colWidth – padding – len(cell), right pad = padding
• Wrapping: if wrapping enabled, break long strings into multiple lines per cell and increase row height accordingly; render each subline as its own line within the row.
• Truncation: replace overflow with “…” or cut exactly to fit.

5 — Advanced features

• Per-column formats (numbers right-aligned, monospace code fixed-width).
• Row or cell merging (colspan/rowspan) — requires calculating spanning widths and rendering with multi-line cells and adjusted borders.
• Color support using ANSI escape codes — applied to cell content only (do not count escapes when measuring width).
• Export modes: plain text, Markdown (| pipe tables), or HTML.

6 — Minimal implementation sketch (pseudocode)

• Parse input rows → normalize columns.
• widths = max cell lengths per column + 2*padding.
• renderBorder(kind, widths): build using chosen characters.
• renderRow(row): for each cell, align and pad; join with separators.
• assemble table: optional top border, header row, optional header separator, body rows, bottom border.

7 — Performance and edge cases

• Very wide tables: consider wrapping or horizontal scrolling.
• Non-printable/ANSI sequences: strip for measurement, preserve in output.
• Mixed character widths (CJK): measure display width, not byte length.

8 — Quick usage examples

• Command-line: pipe CSV into generator to produce a