MYSTNB-DOCUTILS-PSEUDOXML(1)

📦
version 1.3.0 · 6 versions
, in ubuntu resolute, ubuntu stonking

💅 MYSTNB-DOCUTILS-PSEUDOXML(1) 💅

okay so this is the User Commands page for mystnb-docutils-pseudoxml, and yes bestie, the manual name is literally the command name. iconic.

🌸 NAME 🌸

mystnb-docutils-pseudoxml — literally mystnb-docutils-pseudoxml. no cap, that's the whole name.

✨ DESCRIPTION ✨

💫 Usage =====

mystnb-docutils-pseudoxml [options] [<source> [<destination>]]

okay so what it does: it generates pseudo-XML from standalone MyST Notebook sources. It reads from <source> (default is stdin) and writes to <destination> (default is stdout). See https://docutils.sourceforge.io/docs/user/config.html for a detailed settings reference. External outputs are written to --nb-output-folder.

🎀 Options =======

General Docutils Options

  • --output-path=<destination>, --output=<destination> — Output destination name. Obsoletes the <destination> positional argument. Default: None (stdout).
  • --title=<title> — Specify the document title as metadata.
  • --generator, -g — Include a "Generated by Docutils" credit and link.
  • --no-generator — Do not include a generator credit.
  • --date, -d — Include the date at the end of the document (UTC).
  • --time, -t — Include the time & date (UTC).
  • --no-datestamp — Do not include a datestamp of any kind.
  • --root-prefix=<path> — Base directory for absolute paths when reading from the local filesystem. Default "".
  • --source-link, -s — Include a "View document source" link.
  • --source-url=<URL> — Use <URL> for a source link; implies --source-link.
  • --no-source-link — Do not include a "View document source" link.
  • --toc-entry-backlinks — Link from section headers to TOC entries. (default)
  • --toc-top-backlinks — Link from section headers to the top of the TOC.
  • --no-toc-backlinks — Disable backlinks to the table of contents.
  • --footnote-backlinks — Link from footnotes/citations to references. (default)
  • --no-footnote-backlinks — Disable backlinks from footnotes and citations.
  • --section-numbering — Enable section numbering by Docutils. (default)
  • --no-section-numbering — Disable section numbering by Docutils.
  • --strip-comments — Remove comment elements from the document tree.
  • --leave-comments — Leave comment elements in the document tree. (default)
  • --strip-elements-with-class=<class> — Remove all elements with classes="<class>" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)
  • --strip-class=<class> — Remove all classes="<class>" attributes from elements in the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)
  • --report=<level>, -r <level> — Report system messages at or higher than <level>: "info" or "1", "warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5".
  • --verbose, -v — Report all system messages. (Same as "--report=1".)
  • --quiet, -q — Report no system messages. (Same as "--report=5".)
  • --halt=<level> — Halt execution at system messages at or above <level>. Levels as in --report. Default: 4 (severe).
  • --strict — Halt at the slightest problem. Same as "--halt=info".
  • --exit-status=<level> — Enable a non-zero exit status for non-halting system messages at or above <level>. Default: 5 (disabled).
  • --debug — Enable debug-level system messages and diagnostics.
  • --no-debug — Disable debug output. (default)
  • --warnings=<file> — Send the output of system messages to <file>.
  • --traceback — Enable Python tracebacks when Docutils is halted.
  • --no-traceback — Disable Python tracebacks. (default)
  • --input-encoding=<name[:handler]> — Specify the encoding and optionally the error handler of input text. Default: utf-8.
  • --output-encoding=<name[:handler]> — Specify the text encoding and optionally the error handler for output. Default: utf-8.
  • --error-encoding=<name[:handler]>, -e <name[:handler]> — Specify text encoding and optionally the error handler for error output. Default: system encoding.
  • --language=<tag>, -l <tag> — Specify the language (as BCP 47 language tag). Default: en.
  • --record-dependencies=<file> — Write output file dependencies to <file>.
  • --config=<file> — Read configuration settings from <file>, if it exists.
  • --version, -V — Show this program's version number and exit.
  • --help, -h — Show this help message and exit.

MyST-NB options

  • --nb-read-as-md=<boolean> — Read as the MyST Markdown format (default: False).
  • --nb-metadata-key=<str> — Notebook level metadata key for config overrides (default: (default: 'mystnb')).
  • --nb-cell-metadata-key=<str> — Cell level metadata key for config overrides (default: (default: 'mystnb')).
  • --nb-eval-name-regex=<str> — Regex that matches permitted values of eval expressions (default: (default: '^[a-zAZ_][a-zA-Z0-9_]*$')).
  • --nb-execution-mode=<'off'|'force'|'auto'|'cache'|'inline'> — Execution mode for notebooks (default: 'auto').
  • --nb-execution-cache-path=<str> — Path to folder for caching notebooks (default: <outdir>) (default: (default: '')).
  • --nb-execution-timeout=<int> — Execution timeout (seconds) (default: 30).
  • --nb-execution-in-temp=<boolean> — Use temporary folder for the execution current working directory (default: False).
  • --nb-execution-allow-errors=<boolean> — Allow errors during execution (default: False).
  • --nb-execution-raise-on-error=<boolean> — Raise an exception on failed execution, rather than emitting a warning (default: False).
  • --nb-execution-show-tb=<boolean> — Print traceback to stderr on execution error (default: False).
  • --nb-merge-streams=<boolean> — Merge all stdout execution output streams; same with stderr (default: False).
  • --nb-render-plugin=<str> — The entry point for the execution output render class (in group myst_nb.output_renderer) (default: (default: 'default')).
  • --nb-remove-code-source=<boolean> — Remove code cell source (default: False).
  • --nb-remove-code-outputs=<boolean> — Remove code cell outputs (default: False).
  • --nb-scroll-outputs=<boolean> — Make long cell outputs scrollable (default: False).
  • --nb-code-prompt-show=<str> — Prompt to expand hidden code cell {content|source|outputs} (default: (default: 'Show code cell {type}')).
  • --nb-code-prompt-hide=<str> — Prompt to collapse hidden code cell {content|source|outputs} (default: (default: 'Hide code cell {type}')).
  • --nb-number-source-lines=<boolean> — Number code cell source lines (default: False).
  • --nb-builder-name=<str> — Builder name, to select render priority for mime types (default: (default: 'html')).
  • --nb-output-stderr=<'show'|'remove'|'remove-warn'|'warn'|'error'|'severe'> — Behaviour for stderr output (default: 'show').
  • --nb-render-text-lexer=<str> — Pygments lexer applied to stdout/stderr and text/plain outputs (default: (default: 'myst-ansi')).
  • --nb-render-error-lexer=<str> — Pygments lexer applied to error/traceback outputs (default: (default: 'ipythontb')).
  • --nb-render-markdown-format=<'commonmark'|'gfm'|'myst'> — The format to use for text/markdown rendering (default: 'commonmark').
  • --nb-output-folder=<str> — Folder for external outputs (like images), skipped if empty (default: (default: 'build')).
  • --nb-append-css=<boolean> — Add default MyST-NB CSS to HTML outputs (default: True).
  • --nb-metadata-to-fm=<boolean> — Convert unhandled metadata to frontmatter (default: False).

MyST options

  • --myst-commonmark-only=<boolean> — Use strict CommonMark parser (default: False).
  • --myst-gfm-only=<boolean> — Use strict Github Flavoured Markdown parser (default: False).
  • --myst-enable-extensions=<comma-delimited> — Enable syntax extensions.
  • --myst-disable-syntax=<comma-delimited> — Disable Commonmark syntax elements.
  • --myst-all-links-external=<boolean> — Parse all links as simple hyperlinks (default: False).
  • --myst-links-external-new-tab=<boolean> — Open all external links in a new tab (default: False).
  • --myst-url-schemes=<comma-delimited>|<yaml-dict> — URI schemes that are converted to external links (default: http,https,mailto,ftp).
  • --myst-fence-as-directive=<comma-delimited> — Interpret a code fence as a directive, for certain language names. This can be useful for fences like dot and mermaid, and interoperability with other Markdown renderers.
  • --myst-number-code-blocks=<comma-delimited> — Add line numbers to code blocks with these languages.
  • --myst-title-to-header=<boolean> — Convert a title field in the front-matter to a H1 header (default: False).
  • --myst-heading-anchors=<int> — Heading level depth to assign HTML anchors (default: 0).
  • --myst-heading-slug-func=<str> — Function for creating heading anchors, or a python import path e.g. my_package.my_module.my_function (default: (default: 'None')).
  • --myst-html-meta=<yaml-dict> — HTML meta tags.
  • --myst-footnote-sort=<boolean> — Move all footnotes to the end of the document, and sort by reference order (default: True).
  • --myst-footnote-transition=<boolean> — Place a transition before sorted footnotes (default: True).
  • --myst-words-per-minute=<int> — For reading speed calculations (default: 200).
  • --myst-substitutions=<yaml-dict> — Substitutions mapping.
  • --myst-linkify-fuzzy-links=<boolean> — Recognise URLs without schema prefixes (default: True).
  • --myst-dmath-allow-labels=<boolean> — Parse $$...$$ (label) (default: True).
  • --myst-dmath-allow-space=<boolean> — Allow initial/final spaces in $ ... $ (default: True).
  • --myst-dmath-allow-digits=<boolean> — Allow initial/final digits 1$ ...$2 (default: True).
  • --myst-dmath-double-inline=<boolean> — Parse inline $$ ... $$ (default: False).
  • --myst-enable-checkboxes=<boolean> — Enable checkboxes (default: False).
  • --myst-suppress-warnings=<comma-delimited> — A list of warning types to suppress warning messages.
  • --myst-highlight-code-blocks=<boolean> — Syntax highlight code blocks with pygments (default: True).
  • --myst-inventories=<yaml-dict> — Mapping of key to (url, inv file), for intra-project referencing.

Generic Parser Options

  • --no-file-insertion — Disable directives that insert the contents of an external file; replaced with a "warning" system message.
  • --file-insertion-enabled — lets directives insert the contents of an external file into your doc. This one's on by default, bestie ✨
  • --no-raw — turns the "raw" directive off, and instead of your raw content you get a "warning" system message. Rude but honest 💀
  • --raw-enabled — turns the "raw" directive back on. (default) 🫶
  • --line-length-limit=<length> — the absolute max number of characters allowed in an input line. Default is 10 000. Yes, ten thousand. She's long, she's luxurious 🎀
  • --validate — validate the document tree after parsing. Get that vibe check in 🔍
  • --no-validation — do not validate the document tree. (default) 🙈

✨ reStructuredText Parser Options ✨

  • --pep-references — recognize and link to standalone PEP references (like "PEP 258"). Python girlies rise 👑
  • --pep-base-url=<URL> — base URL for PEP references. Default is "https://peps.python.org/" 🌈
  • --pep-file-url-template=<URL> — template for the PEP file part of the URL. Default is "pep-%04d" 🧚
  • --rfc-references — recognize and link to standalone RFC references (like "RFC 822"). Networking besties, this one's for you 💖
  • --rfc-base-url=<URL> — base URL for RFC references. Default is "https://tools.ietf.org/html/" ⭐
  • --tab-width=<width> — set the number of spaces used for tab expansion. Default is 8 📏
  • --trim-footnote-reference-space — remove the spaces that sit before footnote references ✂️
  • --leave-footnote-reference-space — leave those spaces before footnote references exactly where they are 🫶
  • --syntax-highlight=<format> — the token name set used for parsing code with Pygments. It's one of "long", "short", or "none" (which means no parsing at all). Default is "long" 💅
  • --smart-quotes=<yes/no/alt> — swap straight quotation marks for their typographic form. One of "yes", "no", "alt[ernative]". Default is "no" — so no curly quotes unless you ask, no cap 🎀
  • --smartquotes-locales=<language:quotes[,language:quotes,...]> — the characters to use as "smart quotes" for each <language>. Yes, you can stack them with commas 🌍
  • --word-level-inline-markup — inline markup only gets recognized at word boundaries (so, right next to punctuation or whitespace). Want character-level recognition anyway? Force it with \ (backslash + space). This is the default behaviour, iykyk 🦋
  • --character-level-inline-markup — inline markup gets recognized anywhere, no matter what characters are around it. You must use backslash-escapes to avoid unwanted markup recognition. Useful for East Asian languages. Marked experimental — proceed with main character energy but also caution, babe 🫶

🦋 Standalone Reader Options 🦋

  • --no-doc-title — disables the promotion of a lone top-level section title to document title. (And the follow-up move: a subsequent section title being promoted to document subtitle. This whole thing is enabled by default.) 🚫
  • --no-doc-info — disables the bibliographic field list transform. (Enabled by default.) 📚
  • --section-subtitles — activates the promotion of lone subsection titles to section subtitles. (Disabled by default.) ⭐
  • --no-section-subtitles — deactivates the promotion of lone subsection titles. Balanced, as all things should be 💅

👑 "Docutils pseudo-XML" Writer Options 👑

  • --detailed — pretty-print <#text> nodes. She's detailed, she's giving ✨
ok that's genuinely the whole options list, you made it, I'm so proud of you 😭💖 go write some gorgeous pseudo-XML.

This page comes from the debian source, and it's dated January 2026 — so like, future-fresh, iconic behavior honestly 🌸🫶

📦 where this page comes from