PHPackages innobrain/markitdown - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. innobrain/markitdown ActiveLibrary[Parsing & Serialization](/categories/parsing) innobrain/markitdown ==================== Laravel bindings for markitdown. v3.4.0(7mo ago)48.9k↓48.2%1[1 PRs](https://github.com/innobraingmbh/markitdown/pulls)MITPHPPHP ^8.3CI passing Since Dec 16Pushed 2mo ago1 watchersCompare [ Source](https://github.com/innobraingmbh/markitdown)[ Packagist](https://packagist.org/packages/innobrain/markitdown)[ Docs](https://github.com/innobrain/markitdown)[ GitHub Sponsors](https://github.com/Innobrain)[ RSS](/packages/innobrain-markitdown/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (16)Versions (20)Used By (0) Laravel bindings for markitdown. ================================ [](#laravel-bindings-for-markitdown) [![Latest Version on Packagist](https://camo.githubusercontent.com/b6a59b5cf1be36b3cdfbfc8dcea0329cc487862c44b9360d6b8d6579f015f17c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e6e6f627261696e2f6d61726b6974646f776e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/innobrain/markitdown)[![GitHub Tests Action Status](https://camo.githubusercontent.com/b1538b0cf9679c1508bd96c2d04832870d15607c4fe5d5743713a2376e84f4c8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f696e6e6f627261696e676d62682f6d61726b6974646f776e2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/innobraingmbh/markitdown/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/f4bd107f595e2f9d55f94e998761f16b9321ba663cd7b27f2304db3e9e0c48f6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f696e6e6f627261696e676d62682f6d61726b6974646f776e2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/innobraingmbh/markitdown/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/c26e42c8cfe6d3e0e083e3c3eecfa679a5e2cda8c66d029ab81ae64d2fe9a8d5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696e6e6f627261696e2f6d61726b6974646f776e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/innobrain/markitdown) Laravel bindings for markitdown. Installation ------------ [](#installation) 1. Install the package via composer: ``` composer require innobrain/markitdown ``` 2. Publish the configuration file: ``` php artisan vendor:publish --tag="markitdown-config" ``` 3. Run the installation command if you want the package to manage your `markitdown` installation: ``` php artisan markitdown:install ``` This will: - Set up a Python virtual environment with the required dependencies - Add the setup script to your project's composer.json - Ensure the environment is kept up to date with future composer updates ### Alternative Installation Methods [](#alternative-installation-methods) If you prefer not to use the built-in virtual environment, you can disable it in your `.env` file or in the config: ``` MARKITDOWN_USE_VENV_PACKAGE=false ``` Then install markitdown manually using one of these methods: #### Using pip directly: [](#using-pip-directly) ``` pip install markitdown ``` #### Using pipx (Recommended for manual installation): [](#using-pipx-recommended-for-manual-installation) On macOS: ``` brew install pipx pipx ensurepath sudo pipx ensurepath --global # optional to allow pipx actions with --global argument ``` Or see how to install on [other platforms](https://github.com/pypa/pipx). After installing `pipx`, you can install `markitdown` with: ``` pipx install markitdown ``` When not using the built-in virtual environment, you'll need to set the path to the `markitdown` executable in your `.env` file. You can retrieve the path with: ``` which markitdown ``` ``` MARKITDOWN_EXECUTABLE=/path/to/markitdown ``` Also, when running the script anywhere but the console, you need to set the PATH, as php-fpm does not have access to the PATH variable. You can do this by adding the following to your `.env` file: ``` MARKITDOWN_SYSTEM_PATH= ``` Configuration ------------- [](#configuration) The package's configuration will be published to `config/markitdown.php`. Here are the available options: ``` return [ /* * Use this to set the timeout for the process. Default is 30 seconds. */ 'process_timeout' => env('MARKITDOWN_PROCESS_TIMEOUT', 30), /* * Use this to set the path to the markitdown executable. If not set, * the binary will be searched in the PATH. Will be ignored * if use_venv_package is set to true. */ 'executable' => env('MARKITDOWN_EXECUTABLE', 'markitdown'), /* * This will override the above setting and use the new locally installed package. */ 'use_venv_package' => env('MARKITDOWN_USE_VENV_PACKAGE', true), /* * This is needed when you want to run markitdown in php-fpm. One dependency * of markitdown requires PATH to be set. If you are running in a console, * this is not needed. */ 'system' => [ 'path' => env('MARKITDOWN_SYSTEM_PATH', ''), ], /* * The path where temporary files will be stored. This directory must be writable * by the web server. Defaults to storage/app/private/markitdown_tmp */ 'temporary_directory' => env('MARKITDOWN_TEMPORARY_DIRECTORY', storage_path('app/private/markitdown_tmp')), ]; ``` Usage ----- [](#usage) ``` // convert a file: $markdown = \Innobrain\Markitdown\Facades\Markitdown::convert('/path/to/file.docx'); // or convert a file you already have in memory: $file = file_get_contents('/path/to/file.docx'); $markdown = \Innobrain\Markitdown\Facades\Markitdown::convertFile($file, '.docx'); ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) - [Konstantin Auffinger](https://github.com/kauffinger) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 48 — FairBetter than 95% of packages Maintenance76 Regular maintenance activity Popularity30 Limited adoption so far Community11 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 83.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~17 days Recently: every ~41 days Total 18 Last Release 235d ago Major Versions v0.1.4 → v1.0.02024-12-16 v1.0.2 → v2.0.02024-12-18 v2.0.0 → v3.0.02024-12-22 ### Community Maintainers ![](https://www.gravatar.com/avatar/beb1d357716423ec46cf7e3ff0827574b0e17a095bc2cd7b218bf5955056be9b?d=identicon)[innobrain](/maintainers/innobrain) --- Top Contributors [![kauffinger](https://avatars.githubusercontent.com/u/62616071?v=4)](https://github.com/kauffinger "kauffinger (83 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)") --- Tags laravelmarkdownmarkitdownlaravelInnobrainmarkitdown ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/innobrain-markitdown/health.svg) ``` [![Health](https://phpackages.com/badges/innobrain-markitdown/health.svg)](https://phpackages.com/packages/innobrain-markitdown) ``` ### Alternatives [spatie/laravel-health Monitor the health of a Laravel application 86910.0M83](/packages/spatie-laravel-health)[spatie/laravel-pdf Create PDFs in Laravel apps 9963.4M12](/packages/spatie-laravel-pdf)[spatie/laravel-markdown A highly configurable markdown renderer and Blade component for Laravel 4053.4M35](/packages/spatie-laravel-markdown)[wnx/laravel-backup-restore A package to restore database backups made with spatie/laravel-backup. 203330.1k2](/packages/wnx-laravel-backup-restore)[vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-markdown-response Serve markdown versions of your HTML pages to AI agents and bots 6512.6k](/packages/spatie-laravel-markdown-response) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)