kgtk md converts a KGTK input file to a GitHub markdown table on output.
The primary use for this command is to easily produce documentation files. However, there are instances in which the output of this command is more readable than a KGTK TSV file, so this command can also be used as a debugging aid.
This command defaults to
--mode=NONE since it doesn't attach special meaning
to particular columns.
This comand is equivalent to
kgtk cat --MODE=NONE --output-format=md.
However, it is a lot shorter and easier to type.
usage: kgtk md [-h] [-i INPUT_FILE] [-o OUTPUT_FILE] [-v [optional True|False]] Convert a KGTK input file to a GitHub markdown table on output. Use this command to filter the output of any KGTK command: kgtk xxx / md Use it to convert a KGTK file to a GitHub Markdown table in a file: kgtk md -i file.tsv -o file.md This command defaults to --mode=NONE so it will work with TSV files that do not follow KGTK column naming conventions. Additional options are shown in expert help. kgtk --expert md --help optional arguments: -h, --help show this help message and exit -i INPUT_FILE, --input-file INPUT_FILE The KGTK file to convert to a GitHub markdown table. (May be omitted or '-' for stdin.) -o OUTPUT_FILE, --output-file OUTPUT_FILE The GitHub markdown file to write. (May be omitted or '-' for stdout.) -v [optional True|False], --verbose [optional True|False] Print additional progress messages (default=False).
Convert a KGTK Table to a Markdown Table as a Filter¶
Use this command to filter the standard output of any KGTK command to a Github Markdown table:
kgtk xxxxx / md
Convert a KGTk file to a Markdown File¶
Use this command to convert a KGTK file to a GitHub Markdown table in a file:
kgtk md -i xxx.kgtk -o xxx.md