Pandoc-placetable Filter

A Pandoc filter that replaces code blocks (that have the class table) with tables generated from CSV. The CSV is read from the code block and from an optional external CSV file and concatenated. There's a flag to enable parsing of inline markdown.

Some usage examples:

```{.table file="foo.csv"}
```

```{.table}
some,values
even,"with spaces"
"with the inlineMarkdown flag enabled","we _can_ write **Markdown** here"
```

```{.table file="foo.csv" header=yes}
Fruit,Quantity,Price
```

```{.table file="foo.csv" header=yes aligns=LRCRR caption="my caption" delimiter="," quotechar="\"" }
```

All attributes are optional and are specified as follows:

• file: The path to the CSV file that is appended to the code block's content
• header: If set to yes, then the first row of data is interpreted as the table headers.
• aligns: For each column, one letter (L, R or C) that specifies the column's alignment.
• caption: The table caption.
• delimiter: A one-character string used in the CSV to separate fields, defaults to ,. For characters not allowed standing alone in Pandoc markdown attributes, use \t for a tab and \s for a space.
• quotechar: A one-character string that may be used in the CSV to quote fields containing special characters, defaults to ".

When compiled with the inlineMarkdown flag, the CSV and the caption may contain markdown that will be interpreted. The CSV may even contain multiline markdown in a cell (the field need to be quoted, of course). Note that the flag causes Pandoc to be required as a dependency so it will take a while to build.

Installation

cabal update
cabal install pandoc-placetable

or with the inlineMarkdown flag (see above):

cabal install -f inlineMarkdown pandoc-placetable

Usage

Prepare a markdown file containing a fenced code block like the ones above, then:

pandoc --filter pandoc-placetable input.md