# tablemark-cli > Generate markdown tables from JSON data at the command line. Latest version **4.0.0** (published 2025-10-08) · MIT license · 0 weekly downloads ## Install ```sh npm install tablemark-cli pnpm add tablemark-cli yarn add tablemark-cli bun add tablemark-cli ``` Provides the command `tablemark`. ## Health **Score 50/100 (C)** — status: stable. Positive: esm support; no vulnerabilities. Warnings: low downloads; no types. ## Facts | | | |---|---| | Version | 4.0.0 | | Published | 2025-10-08 | | First published | 2017-01-22 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | ESM | | Node | >=20 | | Dependencies | 2 | | Unpacked size | 17.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 22 | | Author | Bo Lingen | | Maintainers | citycide, haltcase | | Keywords | cli, cli-app, markdown, tables, json, convert, generate | ## Links - npm: https://www.npmjs.com/package/tablemark-cli - Repository: https://github.com/haltcase/tablemark-cli - Issues: https://github.com/haltcase/tablemark-cli/issues - npm.io page: https://npm.io/package/tablemark-cli ## Dependencies (2) - [cmd-ts](https://npm.io/package/cmd-ts.md) ^0.14.1 - [tablemark](https://npm.io/package/tablemark.md) ^4.1.0 ## Alternatives - [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads - [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads - [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads - [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads - [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads ## Recent versions - 4.0.0 (latest) — 2025-10-08 - 3.0.0 — 2022-04-30 - 2.0.0 — 2019-07-26 - 1.1.0 — 2017-09-14 - 1.0.0 — 2017-07-08 - 1.0.0-alpha.1 — 2017-01-22 ## README # tablemark-cli · [![npm version](https://img.shields.io/npm/v/tablemark-cli?style=flat-square)](https://www.npmjs.com/package/tablemark-cli) [![license](https://img.shields.io/npm/l/tablemark-cli?style=flat-square)](https://www.npmjs.com/package/tablemark-cli) [![TypeScript](https://img.shields.io/badge/written%20in-TypeScript-294E80?style=flat-square&logo=TypeScript)](http://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/haltcase/tablemark-cli/test.yml?style=flat-square) > Generate markdown tables from JSON data at the command line. Render JSON input data as a markdown table from the command line, powered by the [`tablemark`](https://github.com/haltcase/tablemark) module. This utility supports: - JSON file input from a provided path - Data piped from `stdin` - NDJSON formatted data ([newline delimited JSON](http://ndjson.org/)) - And most options supported by `tablemark` ## Installation ```shell pnpm add --global tablemark-cli # or npm install --global tablemark-cli # or bun install --global tablemark-cli ``` You can also use `pnpx`/`pnpm dlx`, `npx`, `bunx`, etc. to run it without installing: ```sh pnpx tablemark-cli input.json > output.md # or npx tablemark-cli input.json > output.md # or bunx tablemark-cli input.json > output.md ``` ## Usage ``` tablemark 4.0.0 > Generate markdown tables from JSON data at the command line. ARGUMENTS: - Path to input file containing JSON data (use - for stdin) OPTIONS: --align , -a= - Alignment, can be used multiple times [default: left] --align-all, -A - Default alignment for all columns [default: left] --column , -c= - Column name, can be used multiple times [default: infer from object key] --descriptors, -D - Column descriptors as a JSON array, overrides --align/--column [default: none] [optional] --header-case, -H - Control the casing of column names [default: sentenceCase] --line-break-strategy, -l - How to handle line breaks in cell content [default: preserve] --line-ending, -e - End-of-line string [default: \n] [optional] --max-width, -w - Maximum content width of each column [default: Infinity] --overflow-strategy, -o - What to do when cell content exceeds max width [default: wrap] --overflow-header-strategy, -O - What to do when header cell content exceeds max width [default: wrap] --unknown-key-strategy, -u - What to do when an unknown key is encountered [default: ignore] --text-handling-strategy, -t - Which text processing method to use [default: auto] --wrap-width - (Deprecated) Alias for --max-width [default: Infinity] FLAGS: --count-ansi - Count ANSI escape codes towards content width --no-case-headers, -N - (Deprecated) Disable automatic sentence casing of inferred column names --no-pad-header-separator, -P - Omit padding on the header separator row --wrap-with-gutters, -G - Add '|' characters to wrapped rows --help, -h - show help --version, -v - print the version ``` To apply the `align` and `column` options to multiple columns, supply the flag multiple times, like this: ```sh tablemark input.json > output.md -a left -a center -a right ``` ... which will align the first three columns left, center, and right respectively. ## Piped input (`stdin`) In bash-like shells: ```sh # stdin -> stdout echo '{ "one": 1 }' | tablemark - # redirect input file content into stdin, then to a file tablemark - < input.json > output.md ``` In PowerShell: ```powershell # stdin -> stdout '{ "one": 1 }' | tablemark - # redirect input file content into stdin, then to a file cat input.json | tablemark - > output.md ``` ## NDJSON [NDJSON](http://ndjson.org) is a form of JSON that delimits multiple JSON objects by newlines: ```js {"name":"trilogy","repo":"[haltcase/trilogy](https://github.com/haltcase/trilogy)","desc":"No-hassle SQLite with type-casting schema models and support for native & pure JS backends."} {"name":"strat","repo":"[haltcase/strat](https://github.com/haltcase/strat)","desc":"Functional-ish JavaScript string formatting, with inspirations from Python."} {"name":"tablemark-cli","repo":"[haltcase/tablemark-cli](https://github.com/haltcase/tablemark-cli)","desc":"Generate markdown tables from JSON data at the command line."} ``` This input from a file or stdin is supported just as if it were a JSON compatible array: ```sh tablemark input.ndjson > output.md ``` ## See also - [`tablemark`](https://github.com/haltcase/tablemark) – the module used by this utility ## Contributing Search the [issues](https://github.com/haltcase/tablemark-cli) if you come across any trouble, open a new one if it hasn't been posted, or, if you're able, open a [pull request](https://help.github.com/articles/about-pull-requests/). Contributions of any kind are welcome in this project. The following people have already contributed their time and effort: - Thomas Jensen (**[@tjconcept](https://github.com/tjconcept)**) Thank you! ## License MIT © Bo Lingen / haltcase --- _Source: https://npm.io/package/tablemark-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._