1
0
mirror of synced 2025-12-21 10:57:10 -05:00
Files
docs/content/github/managing-files-in-a-repository/rendering-csv-and-tsv-data.md
Jason Etcovitch caaee7a124 Update all files to use {% data %} (#15253)
* Add back changes from prior to purge

* Manually fix some invalid Liquid

* Updoot render-content

* Improve test messages to show correct output

* Run el scripto

* Pass the remaining test
2020-09-29 16:01:04 -04:00

1.5 KiB

title, redirect_from, versions
title redirect_from versions
Rendering CSV and TSV data
/articles/rendering-csv-and-tsv-data
free-pro-team enterprise-server
* *

GitHub supports rendering tabular data in the form of .csv (comma-separated) and .tsv (tab-separated) files.

Rendered CSV sample

When viewed, any .csv or .tsv file committed to a {% data variables.product.product_name %} repository automatically renders as an interactive table, complete with headers and row numbering. By default, we'll always assume the first row is your header row.

You can link to a particular row by clicking the row number, or select multiple rows by holding down the shift key. Just copy the URL and send it to a friend.

Searching data

If you want to find a certain value in your dataset, you can start typing in the search bar directly above the file. The rows will filter automagically:

Searching for values

Handling errors

Occasionally, you may discover that your CSV or TSV file isn't rendering. In those instances, an error box appears at the bottom of your raw text, suggesting what the error may be.

CSV render error message

Common errors include:

  • Mismatched column counts. You must have the same number of separators in each row, even if the cell is blank
  • Exceeding the file size. Our rendering only works for files up to 512KB. Anything bigger than that slows down the browser.