Overview
dsh-markitdown
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- Conversion runs as a child process of the dsh host; the harness Bash approval flow does not gate it, so the plugin validates paths (absolute, existing, extension allow-list, size cap) before invoking MarkItDown. - Scanned PDFs without a text layer convert to little or no text. - Complex layouts flatten into linear Markdown. DOCX embedded images are exported as files (`<name>.media/` beside the Markdown) and linked by path; inline conversions export to a temp directory that the OS may clean up, so pass `output`/`outputDir` when the images should persist. With `allowedRoot` set, inline conversions keep the data URIs rather than writing outside the workspace. - Image descriptions are one-shot: when exact wording matters, open the exported original (`read_image`) instead of trusting the description. - This plugin does not install Python packages by itself; run `markitdown_check` and follow its setup guidance.