mdtable-cli

Command line tool for generating markdown tables. It takes in CSV-formatted data and converts it into a markdown table.

Demo gif

See also the Crates.io page.

Usage

The application expects each row of the table as rows in the input, i.e rows separated by newlines. Each element of the row is seperated by a , (or another value see flag -s). This can either come from a file with a positional argument or from stdin. If from stdin you can signal the end of the table by either EOF or by an empty line (i.e hitting enter twice).

Here are some example cli usages:

mdtable mdtable table.csv -o mdtable.md mdtable table.csv > mdtable.md cat table.csv | mdtable > mdtable.md

See Options for a full description program arguments.

For examples of input and corresponding output see examples.md

Installation

If you're a rust programmer (e.g you have rustc and cargo) simply do: cargo install mdtable-cli

If you don't want to download rustc and cargo you can download the binary directly from the releases page. Put it in a folder in your path, for example /usr/local/bin.

Building from source

If you don't trust random binaries from github you can build it yourself from source: git clone git@github.com:AxlLind/mdtable-cli.git cd mdtable-cli cargo build --release cp target/release/mdtable /usr/local/bin/

Options

``` USAGE: mdtable [FLAGS] [OPTIONS] [FILE]

FLAGS: -h, --help Prints help information -m, --minimize Minimizes table output -V, --version Prints version information

OPTIONS: -o, --out Prints output to this. [default: stdout] -s, --separator Separates values. [default: ,]

ARGS: Reads table tables from this. [default: stdin] ```