Forum Discussion

Isabellais's avatar
Isabellais
Bronze Contributor
Sep 08, 2026

Can you turn a PDF into a Markdown md file?

I have a few PDF documents that I'd like to convert into Markdown (.md) files so I can edit and organize the content more easily. The PDFs contain mostly text, headings, lists, and a few tables. I'm...
Features
LeonardoWilson's avatar
LeonardoWilson
Iron Contributor
Sep 08, 2026

For users who need to convert pdf to markdown md file for work, Marker is a document conversion tool that preserves elements such as headings, tables, equations, links, code blocks, and images when generating Markdown files. The tool runs locally and supports CPU, GPU, and Apple Silicon via MPS. It requires Python 3.10 or later and PyTorch.

How to Convert a PDF to a Markdown (MD) File

Step 1: Make sure Python 3.10 or later is installed on your computer. The project also requires PyTorch, and the appropriate CPU or GPU configuration depends on your hardware.

Step 2: Open Command Prompt, PowerShell, or Terminal and install the package with this single command.

pip install marker-pdf

This is the installation method provided by the project.

Step 3: After installation, launch the included graphical interface by running marker_gui. If the GUI dependencies are required separately in your installation, follow the current project instructions for installing Streamlit.

Step 4: Open the local interface displayed in your browser and select the PDF document you want to process.

Step 5: Choose Markdown as the output format. Adjust the available conversion settings when necessary, especially for scanned documents that require OCR.

Step 6: Start the conversion and wait for the document to be processed. Processing time depends on the number of pages, document complexity, and available CPU or GPU resources.

Step 7: Open the output directory after processing is complete. The generated Markdown content and extracted images are saved there. Review tables, equations, headings, and other complex formatting because PDF layouts do not always translate perfectly into Markdown.

This tool also allows you to convert PDFs directly via the command line using marker_single,but if you prefer not to use additional commands, the graphical interface is more convenient. For scanned documents or documents with unusual formats, you may need to perform OCR processing or make additional configurations to achieve better results.