How to convert PDF to Markdown directly in terminal

Why convert PDF files into the Markdown format

PDF documents are excellent for preserving the exact visual layout of a page, but they often become a major headache when we need to extract content for reuse. Markdown, on the other hand, is a lightweight, universal text format that facilitates reading, storage in code repositories, and quick editing. In practice, this means you gain the freedom to turn static reports into dynamic, easily versioned text blocks.

When dealing with dozens of technical documents, manuals, or scientific papers, opening each file in a visual editor to copy and paste becomes an unsustainable task. That is where the power of the command line comes in, allowing you to create repeatable and fast routines. Before starting this automation journey, remember that, much like we saw when converting scanned documents with OCR, understanding the type of file you have on hand dictates the success of the entire process.

Essential tools for command-line text extraction

The open-source ecosystem offers fantastic utilities that run directly in the terminal, eliminating the need for heavy proprietary software. Among developers' favorites are libraries that read the internal document tree and convert visual elements into semantic markup. The primary goal is to maintain the hierarchy of headings, lists, and paragraphs without requiring the user to redo all the formatting manually.

Many of these tools use Python engines or compiled C binaries to ensure high performance when reading dense files. If you have ever needed to extract tabular data or convert other formats, such as transforming CSV spreadsheets into structured JSON using sed, you know that mastering the text interface eliminates unnecessary middlemen and drastically cuts down time spent on repetitive tasks.

Setting up the environment and preparing the system

Before running any conversion command, we must ensure the operating system has the necessary dependencies installed. On Debian or Ubuntu-based Linux distributions, installing utility packages for document manipulation can be done quickly through the standard package manager. Let's update the package list and install the essential reading and conversion tools.

Open your terminal and run the commands below to prepare the ground:

sudo apt update && sudo apt install -y python3-pip poppler-utils pandoc

The poppler-utils package provides vital utilities like pdftotext, while pandoc acts as the Swiss Army knife of text format conversion. With these foundations installed, your system is ready to process the vast majority of documents that cross your path.

Executing the conversion step-by-step in the terminal

With the tools properly installed, the conversion workflow boils down to executing targeted commands in the directory where the PDF file is stored. To ensure the extracted text maintains some logical structure, we can combine dedicated converters with Pandoc. Below is the practical procedure to carry out this transformation cleanly and directly.

Follow the steps below in your command line:

1. Navigate to the folder where the PDF file is saved using the cd command.
2. Run the raw extractor to convert the PDF into an intermediate text file.
3. Convert the generated text file to Markdown using Pandoc to structure the elements.

To execute the second step mentioned in the list, for instance, the typical terminal command follows this basic syntax:

pdftotext -layout my-document.pdf intermediate-file.txt

The -layout parameter instructs the utility to attempt to preserve the original visual arrangement of columns and line breaks, preventing the text from becoming completely scrambled when read by humans or AI software.

Automating file batches with a simple script

When the workload grows and we need to convert hundreds of files at once, running individual commands is no longer viable. The elegant solution for this scenario is to write a small Shell script that iterates through an entire folder, applying the conversion in a loop. This approach is very similar to the logic we applied when converting batches of M4A audio to MP3 with FFmpeg, where automation eliminates manual labor.

Below is a classic example of a Bash loop that locates all PDF files in the current folder and generates their Markdown equivalents:

for file in *.pdf; do
  base_name=$(basename "$file" .pdf)
  pdftotext -layout "$file" "${base_name}.txt"
  pandoc "${base_name}.txt" -o "${base_name}.md"
  rm "${base_name}.txt"
  echo "Converted: ${base_name}.md"
done

This small block of code loops through all files with the PDF extension, extracts text while preserving layout, converts it to the final Markdown format, deletes the temporary plain text file, and displays a success message on the screen. It is a robust routine that saves hours of manual work.

Final considerations on document workflows

Mastering the conversion of complex documents via terminal transforms how we manage notes, articles, and technical documentation on a daily basis. By combining lightweight utilities like poppler and pandoc, we build a fast, reliable pipeline completely independent of heavy graphical interfaces. With practice, these small scripts become a fundamental part of your productivity and engineering toolbox.

Investing time in automating repetitive tasks always yields exponential long-term returns. Whether organizing a personal study library or integrating documents into an intelligent search system, mastering the terminal guarantees total control over your data.