/

For the complete documentation index, see llms.txt. This page is also available as Markdown.

On this page

Table from CSV

The .csv {path} {mode?} {caption?} docs ↗ function loads a table from a CSV file. The first row of the CSV file always serves as the header row.

The path parameter can be either a path relative to the main source file’s location or an absolute path. Use a slash (/) as the path separator, regardless of the operating system.

Tables loaded from CSV can also be manipulated. See Table manipulation for more information.

Example 1

.csv {assets/people.csv}
UsernameBirth yearFavorite foodFavorite drink
john1992ChickenOrange juice
iamgio2002PastaIced tea
daniel1986SushiBeer

You can also provide a caption.

Example 2

.csv {assets/people.csv} caption:{People data.}
UsernameBirth yearFavorite foodFavorite drink
john1992ChickenOrange juice
iamgio2002PastaIced tea
daniel1986SushiBeer
People data.

The mode parameter controls how the CSV file is parsed. It defaults to plain, which treats all cell content as plain text. If set to markdown, Quarkdown parses cell content as inline Quarkdown source code, allowing formatting, rich content, and inline function calls within the CSV.

Name,  Favorite drink, Age *(as of 2026)*
Alice, Coffee,         .subtract {2026} {1995}
Bob,   *Pepsi*,        .subtract {2026} {2001}

Example 3

.csv {assets/people2.csv} mode:{markdown}
NameFavorite drinkAge (as of 2026)
AliceCoffee31
BobPepsi25