# Excel to Markdown

Turn an Excel workbook (.xlsx) into Markdown tables, one per sheet, with dates in ISO form.

Reads the cells of each sheet straight from the file and writes them as Markdown tables under a heading with the sheet name. Large sheets are read in a stream, so a sheet with a million rows does not need to fit in memory. Made for giving a spreadsheet to a language model.

- Endpoint: `POST https://setget.net/v1/tools/xlsx-to-markdown` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `xlsx-to-markdown`
- Page: https://setget.net/tools/xlsx-to-markdown

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `file` (required, file, a file reference such as `DROP_ID/f1`, accepts zip, binary): The Excel workbook (.xlsx) to convert.
- `sheet` (optional, string): Convert only this sheet: its name, or its number counted from 1. Leave empty for all sheets.
- `max_rows` (optional, integer, default `1000`, range 1..20000): Most rows to take from each sheet.
- `max_columns` (optional, integer, default `50`, range 1..200): Most columns to take from each sheet.

## Example 1: Every sheet as a Markdown table

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.xlsx](https://setget.net/static/samples/sample.xlsx).

```json
{"input":{"file":"DROP_ID/f1"},"wait":30}
```

## Example 2: The first rows of one sheet

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.xlsx](https://setget.net/static/samples/sample.xlsx).

```json
{"input":{"file":"DROP_ID/f1","sheet":"Sales","max_rows":3},"wait":30}
```

**What happens to formulas?** Each formula is shown as the result that was saved in the file. The file is not recalculated, so a workbook saved by a program that does not store results shows empty cells there.

**How are dates and numbers written?** Dates as 2026-03-31, times as 14:30:00, both together as 2026-03-31T14:30:00. Percentages keep their % sign. Other numbers are written plainly, without currency signs or thousands separators.

**What if a sheet is very large?** Each sheet is cut at max_rows rows and max_columns columns, and a line under the table says so. Raise the limits (up to 20,000 rows and 200 columns), or pick one sheet with "sheet".

**Which row is the header?** The first filled row of each sheet. Empty rows are left out.

**Can it read .xls or .csv files?** Not .xls: save it as .xlsx first. For CSV use csv-to-markdown-table or any-to-markdown.

**Where is the Markdown?** In a file named after your upload, ending in .md. The result also holds the Markdown itself in "markdown" when it is up to 200,000 characters; "truncated" is true when only the start fits there.

**Does it fetch anything from the internet?** No. Links and picture addresses found in the file are copied as text. Nothing they point to is opened or downloaded.
