Markitdown File To Markdown

Output Rules

• Keep the final output generic. Do not assume any Obsidian, wiki, or vault layout.
• If metadata such as title, author, or source is unavailable, omit it or derive a sensible fallback from the filename.
• Preserve the converter's headings, lists, ordering, spacing, and wording as much as possible.
• Do not compress, summarize, or reorganize the document by default.
• The default result should look like raw MarkItDown output with metadata prepended, not like a separate editorial summary.
• When the user explicitly asks for a summary or cleaned rewrite, that is a different mode and should be treated as an override.

Command

bash scripts/run_markitdown.sh "/absolute/path/to/source.pdf"

Optional output override for raw dumps:

bash scripts/run_markitdown.sh "/absolute/path/to/source.pdf" --output "/absolute/path/to/output.md"

Notes

• The helper script bootstraps its own isolated environment and does not assume markitdown is installed globally.
• Prefer uv if available; otherwise use python3 -m venv.
• The bundled runtime installs a stable MarkItDown release and can be extended later if you need extra format-specific dependencies.
• Keep v1 narrow: do not add alternate converters or manual fallback extraction logic.