yq/usage/csv-tsv.md

# Working with CSV and TSV

## Yaml to CSV/TSV

You can convert compatible yaml structures to CSV or TSV by using:
- `--outputformat=csv` or `-o=c` for csv (comma separated values)
- `--outputformat=tsv` or `-o=t` for tsv (tab separated values)

Compatible structures is either an array of scalars (strings/numbers/booleans), which is a single row; or an array of arrays of scalars (multiple rows).

```yaml
- [i, like, csv]
- [because, excel, is, cool]
```

then

```bash
yq e '.' -o=csv sample.yaml
```

will output:

```csv
i,like,csv
because,excel,is,cool
```

Similarly, for tsv:

```bash
yq e '.' -o=tsv sample.yaml
```

will output:

```tsv
i	like	csv
because	excel	is	cool
```