Skip to content

TSTool / Command / WriteTableToMarkdown


Overview

The WriteTableToMarkdown command writes a table to a Markdown format file. See:

It can be used to provide tabular data for documentation. It is also useful to write tables to Markdown text files for automated tests.

The default is to use | as the column separator without any column justification specified.

Command Editor

The command is available in the following TSTool menu:

  • Commands(Table) / Output Table

The following dialog is used to edit the command and illustrates the command syntax.

WriteTableToMarkdown command editor

WriteTableToMarkdown Command Editor (see full-size image)

Command Syntax

The command syntax is as follows:

WriteTableToMarkdown(Parameter="Value",...)

Command Parameters

Parameter                           Description Default                
TableID
required
Identifier for the table to write. Can be specified using processor ${Property}. None – must be specified.
OutputFile
required
The name of the file to write, as an absolute path or relative to the command file location. Can be specified using processor ${Property}. None – must be specified.
Append Whether to append to an existing file (True) or write a new file (False). False
IncludeColumns The names of columns to write, separated by commas. Write all of the columns.
ExcludeColumns The names of columns to not write, separated by commas. Write all of the included columns.
WriteHeaderComments Indicates whether to write the file header comments, True or False. File header comments include information about the creator of the file. Comments are written as HTML <!-- --> comment, which typically passes through software that converts Markdown to HTML for viewing. False
LinkColumns Indicate columns that are links and specify the corresponding column containing the link text, using the format: LinkColumn1:LinkTextColumn1,LinkColumn2:LinkTextColumn2,... Links are automatically detected and the link text is the same as the link URI.
NaNValue The value to write for NaN data values. Specify the word Blank to write a blank (empty string). NaN
OutputSchemaFile Name of schema file to write, useful to help other software understand contents of the delimited file. See the OutputSchemaFormat parameter. This is an experimental feature being evaluated to facilitate data exchange between software. Do not create schema file.
OutputSchemaFormat Schema format, one of the following, output is limited but will be expanded in the future: JSONTableSchema

Examples

See the automated tests.

Troubleshooting

See the main TSTool Troubleshooting documentation.

See Also