---
title: "CSV to Markdown"
method: POST
path: "/api/v1/tools/csv-to-markdown"
tags: ["tools"]
---

# CSV to Markdown

`POST /api/v1/tools/csv-to-markdown`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/csv-to-markdown`
- Auth: HTTP bearer

Turn CSV text into a GitHub-style Markdown table. Detects the delimiter (comma, semicolon, tab or pipe) unless told, reads quoted fields with embedded delimiters and newlines, and can align columns and pad cells so the table lines up in plain text.

## Request body

- object
  - `csv` string
  - `delimiter` string
  - `firstRowHeader` boolean
  - `padded` boolean
  - `alignment` string

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `markdown` string
    - `rows` integer
    - `columns` integer
    - `delimiter` string
    - `raggedLines` unknown[]
      - unknown

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)
