dsh-markitdown

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.