CLI Commands#
rst2myst#
CLI for converting ReStructuredText to MyST Markdown.
rst2myst [OPTIONS] COMMAND [ARGS]...
Options
- --version#
Show the version and exit.
ast#
Parse file / stdin (-) and print RST Abstract Syntax Tree.
rst2myst ast [OPTIONS] PATH_OR_STDIN
Options
- -l, --language <language>#
Language code for directive names
- Default:
en
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
- -c, --conversions <PATH>#
YAML file mapping directives -> conversions
- --config <config>#
YAML file to read default configuration from
Arguments
- PATH_OR_STDIN#
Required argument
convert#
Convert one or more files.
rst2myst convert [OPTIONS] [PATHS]...
Options
- -d, --dry-run#
Do not write/remove any files
- -R, --replace-files#
Remove parsed files
- -S, --stop-on-fail#
Stop on first failure
- -W, --raise-on-warning#
Raise exception on parsing warning
- -l, --language <language>#
Language code for directive names
- Default:
en
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
- -dd, --default-domain <default_domain>#
Default sphinx domain
- Default:
py
- -dr, --default-role <default_role>#
Default sphinx role [default: convert to literal]
- -cp, --cite-prefix <cite_prefix>#
Prefix to add to citation references
- Default:
cite
- --consecutive-numbering, --no-consecutive-numbering#
Apply consecutive numbering to ordered lists
- Default:
True
- --colon-fences, --no-colon-fences#
Use colon fences for directives with parsed content
- Default:
True
- --dollar-math, --no-dollar-math#
Convert math (where possible) to dollar-delimited math
- Default:
True
- -c, --conversions <PATH>#
YAML file mapping directives -> conversions
- --encoding <encoding>#
Encoding for read/write
- Default:
utf8
- --config <config>#
YAML file to read default configuration from
Arguments
- PATHS#
Optional argument(s)
directives#
Commands for showing available directives.
rst2myst directives [OPTIONS] COMMAND [ARGS]...
list#
List available directives.
rst2myst directives list [OPTIONS]
Options
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
show#
Show information about a single role.
rst2myst directives show [OPTIONS] NAME
Options
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
- -l, --language <language>#
Language code for directive names
- Default:
en
Arguments
- NAME#
Required argument
roles#
Commands for showing available roles.
rst2myst roles [OPTIONS] COMMAND [ARGS]...
list#
List available roles.
rst2myst roles list [OPTIONS]
Options
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
show#
Show information about a single role.
rst2myst roles show [OPTIONS] NAME
Options
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
- -l, --language <language>#
Language code for directive names
- Default:
en
Arguments
- NAME#
Required argument
stream#
Parse file / stdin (-) and print Markdown text.
rst2myst stream [OPTIONS] PATH_OR_STDIN
Options
- -l, --language <language>#
Language code for directive names
- Default:
en
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
- -dd, --default-domain <default_domain>#
Default sphinx domain
- Default:
py
- -dr, --default-role <default_role>#
Default sphinx role [default: convert to literal]
- -cp, --cite-prefix <cite_prefix>#
Prefix to add to citation references
- Default:
cite
- --consecutive-numbering, --no-consecutive-numbering#
Apply consecutive numbering to ordered lists
- Default:
True
- --colon-fences, --no-colon-fences#
Use colon fences for directives with parsed content
- Default:
True
- --dollar-math, --no-dollar-math#
Convert math (where possible) to dollar-delimited math
- Default:
True
- -c, --conversions <PATH>#
YAML file mapping directives -> conversions
- --config <config>#
YAML file to read default configuration from
Arguments
- PATH_OR_STDIN#
Required argument
tokens#
Parse file / stdin (-) and print Markdown-It tokens.
rst2myst tokens [OPTIONS] PATH_OR_STDIN
Options
- -l, --language <language>#
Language code for directive names
- Default:
en
- --sphinx, --no-sphinx#
Load sphinx.
- Default:
True
- -e, --extensions <extensions>#
A comma-separated list of sphinx extensions to load.
- -dd, --default-domain <default_domain>#
Default sphinx domain
- Default:
py
- -dr, --default-role <default_role>#
Default sphinx role [default: convert to literal]
- -cp, --cite-prefix <cite_prefix>#
Prefix to add to citation references
- Default:
cite
- --colon-fences, --no-colon-fences#
Use colon fences for directives with parsed content
- Default:
True
- --dollar-math, --no-dollar-math#
Convert math (where possible) to dollar-delimited math
- Default:
True
- -c, --conversions <PATH>#
YAML file mapping directives -> conversions
- --config <config>#
YAML file to read default configuration from
Arguments
- PATH_OR_STDIN#
Required argument