Docs for 4.16.1

usage/csv-tsv.md

@@ -0,0 +1,41 @@
+# 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
+```
+