SmartQueryTools

Convert Parquet to Markdown Table Online

Convert Parquet files to a Markdown table directly in your browser. Copy the output and paste it into any Markdown document.

About converting Parquet to Markdown

Parquet to Markdown is for putting a slice of analytics data where people read text: a GitHub issue or pull request, a Confluence or Notion page, a README that shows what a dataset looks like, or a message to an AI assistant. It is often the fastest way to answer the question "what is in this Parquet file?" in a code review without asking colleagues to install anything. GitHub renders the result as a proper table in issues, comments and .md files.

The table is built from the first 1,000 rows. That is already more than a readable Markdown table should hold. In practice, pick the handful of columns and rows that make your point in the SQL Query tool, then convert, so the table fits on a screen.

Markdown pipe tables have no types and no cell alignment by default, so every value is printed as plain text in the order of the Parquet schema. A pipe character inside a value is escaped as \| so it does not split the cell, and a line break inside a value becomes <br>, which GitHub renders as a line break inside the cell.

Worked example

A small orders export with an ID, a customer name, a date, an amount (one missing) and a true/false flag, converted with the default settings.

Input (Parquet)

Parquet file (binary, columnar) — shown as a table with its schema

order_idcustomerorder_dateamountshipped
1001Acme Ltd2026-03-02249.5true
1002Brightside Co2026-03-021200false
1003Acme Ltd2026-03-0589.99true
1004Northwind2026-03-07NULLfalse

Schema: order_id BIGINT, customer VARCHAR, order_date DATE, amount DOUBLE, shipped BOOLEAN

Output (Markdown)

| order_id | customer | order_date | amount | shipped |
| --- | --- | --- | --- | --- |
| 1001 | Acme Ltd | 2026-03-02 | 249.5 | true |
| 1002 | Brightside Co | 2026-03-02 | 1200 | false |
| 1003 | Acme Ltd | 2026-03-05 | 89.99 | true |
| 1004 | Northwind | 2026-03-07 |  | false |

What changes when you convert Parquet to Markdown

  • The first line holds the column names, the second holds a --- separator for each column, and each row follows as a pipe-delimited line.
  • Numbers, DECIMAL digits, booleans and timestamps are printed as text. Timestamps show as 2026-03-02 09:15:00 in UTC.
  • NULL becomes an empty cell. Order 1004 shows nothing between the pipes for amount.
  • Pipes in values are escaped and line breaks become <br>, so long free-text columns do not break the table.
  • Struct, list and map cells show as compact JSON text. Select the fields you want as plain columns first.

Your file is processed locally in your browser and is never uploaded. The free limit is 50 MB per file; larger files work if your device has the memory for them.

Frequently Asked Questions

How many rows of my Parquet file end up in the table?

Up to the first 1,000. If the file is larger the output is cut at that point. Use ORDER BY and LIMIT in the SQL Query tool to choose which rows appear.

Will the table render on GitHub?

Yes. The output uses GitHub Flavored Markdown pipe table syntax, which GitHub, GitLab, Notion, Obsidian and most static site generators render.

Can I right-align numeric columns?

Change the separator under a column from --- to ---: after converting. The converter does not set alignment because Markdown has no per-type rule for it.

What is Markdown format?

Markdown is a lightweight plain-text format that renders as formatted content. Markdown tables can be embedded directly in README files, wikis, documentation sites, and any tool that supports CommonMark or GitHub Flavoured Markdown.

Related Tools