{"id":27942,"library":"markitdown-no-magika","title":"MarkItDown (without magika)","description":"A variant of the Microsoft MarkItDown library for converting various file formats (Office docs, images, PDFs, etc.) to Markdown, specifically without the magika dependency for file type detection. Current version 0.1.2, based on markitdown 0.1.2. Release cadence is irregular; the underlying markitdown has frequent updates.","status":"active","version":"0.1.2","language":"python","source_language":"en","source_url":"https://github.com/microsoft/markitdown","tags":["markdown","conversion","file-converter","microsoft","without-magika"],"install":[{"cmd":"pip install markitdown-no-magika","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Core library, pinned to exactly 0.1.2","package":"markitdown","optional":false}],"imports":[{"note":"Despite the package name 'markitdown-no-magika', the module is still 'markitdown'.","symbol":"MarkItDown","correct":"from markitdown import MarkItDown"}],"quickstart":{"code":"from markitdown import MarkItDown\nmd = MarkItDown()\nresult = md.convert(\"example.docx\")\nprint(result.markdown)","lang":"python","description":"Convert a file to Markdown using the default converter."},"warnings":[{"fix":"Ensure only one variant is installed or use virtual environments.","message":"The package name is 'markitdown-no-magika', but the import statement remains 'from markitdown import ...'. This can cause confusion if both markitdown and markitdown-no-magika are installed.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'convert_uri' instead of 'convert_url'.","message":"The method 'convert_url' is deprecated in favor of 'convert_uri' since v0.1.1. It still works as an alias but may be removed in future.","severity":"deprecated","affected_versions":">=0.1.1"},{"fix":"Install needed extras: 'pip install markitdown[pdf]' or 'pip install markitdown[all]'.","message":"Dependency organization changed in v0.1.0; optional converters (e.g., PDF, images) require installing extras like 'markitdown[pdf]' or 'markitdown[all]'. Without extras, some file types fail silently.","severity":"breaking","affected_versions":">=0.1.0"},{"fix":"Do not manually upgrade markitdown; rely on this package's version constraints.","message":"The 'markitdown-no-magika' package pins 'markitdown' to exactly 0.1.2 and removes magika dependency. Upgrading markitdown independently breaks the install.","severity":"gotcha","affected_versions":"0.1.2"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'pip install markitdown-no-magika' which automatically installs 'markitdown' as a dependency.","cause":"The package is installed as 'markitdown-no-magika', but the import uses 'markitdown'. This error occurs if the underlying 'markitdown' package is not present.","error":"ModuleNotFoundError: No module named 'markitdown'"},{"fix":"Replace 'md.convert_url(...)' with 'md.convert_uri(...)'.","cause":"The method 'convert_url' was renamed to 'convert_uri' in v0.1.1. Using older code with newer library versions.","error":"AttributeError: 'MarkItDown' object has no attribute 'convert_url'"},{"fix":"Install the required extra: 'pip install markitdown[pdf]' or 'pip install markitdown[all]'.","cause":"Missing optional dependency for the file format (e.g., PDF, image). The base install of markitdown-no-magika does not include all converters.","error":"ValueError: Could not convert file: unsupported file type"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}