CSV & TSV to Markdown Table Converter

Bridging spreadsheets and plain text Markdown

Tabular data is the backbone of technical documentation, architectural comparisons, financial models, and meeting action logs. However, transferring data between spreadsheet software (such as Microsoft Excel, Google Sheets, or Apple Numbers) and Markdown files has historically required tedious manual pipe formatting.

When you copy cells from a spreadsheet, your operating system clipboard stores them as tab-separated text (TSV). Pasting this directly into a standard Markdown editor yields unformatted text with irregular tab spacing. This converter bridges that gap, instantly transforming raw clipboard text into fully padded, compliant GitHub Flavored Markdown (GFM) pipe tables.

The mechanics of GitHub Flavored Markdown tables

In GFM and Obsidian, tables are constructed using vertical bars (|) to delimit columns and a mandatory second delimiter row containing hyphens to separate headers from data rows:

• Left alignment (:---): The default alignment for text, descriptions, and feature names. Placed with a leading colon on the delimiter row.
• Right alignment (---:): The standard alignment for numbers, timestamps, percentages, and financial quantities. Placed with a trailing colon.
• Center alignment (:---:): Placed with colons at both ends, ideal for status badges, boolean indicators (Yes/No), and category codes.

Preserving data integrity and safety

This browser converter handles common edge cases that break naive conversion scripts:

• Quoted cells with embedded commas: Standard CSV fields often enclose sentences in quotation marks (e.g., "Apples, oranges, and pears"). This tool uses a stateful lexical parser to ensure embedded commas do not create erroneous column splits.
• Escaped quotation marks: Correctly handles double-quoted escape sequences ("") within data cells.
• Pipe character protection: If a cell contains a pipe character (|), the converter automatically escapes it as \| so it does not prematurely terminate the table column.
• CSV formula injection mitigation: In environments where tables may later be re-exported to spreadsheets, cells starting with formula characters (=, +, -, @) are automatically guarded with a leading apostrophe.

Native Markdown tables in your desktop workflow

While browser tools are ideal for quick conversions, working with tables should not require constantly switching tabs. At Oyma, we built a native spreadsheet-like table editor directly into our macOS application. You can paste tabular data directly into your notes, sort columns, insert rows via keyboard shortcuts, and navigate cells with arrow keys—all while the underlying file remains 100% plain Markdown on disk. Explore our spreadsheet-like tables feature, or use our Markdown Table Formatter to tidy up existing tables.