How do I install the Mistral Ocr Markdown skill?

Run npx skillmds@latest add aikarjal/mistral-ocr-markdown in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mistral Ocr Markdown safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mistral Ocr Markdown?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mistral Ocr Markdown free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mistral Ocr Markdown?

aikarjal (@aikarjal) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mistral Ocr Markdown by aikarjal — Agent Skill

Name: Mistral Ocr Markdown
Author: aikarjal

Mistral Ocr Markdown

Convert local PDF and image files into markdown using Mistral OCR. Use when an agent needs reliable document text extraction for downstream analysis, summarization, chunking, indexing, or QA workflows where the source input is a PDF/image file and the output must be markdown.

aikarjal 77df3c1 4 files · 4.4 KB Updated Sep 17, 2026

File contents

Mistral OCR Markdown

Overview

Use the bundled TypeScript CLI to convert one local PDF/image file into one markdown file via Mistral OCR.

Workflow

Validate that the input file path exists and is a single local document.
Resolve API key from CLI flag or environment.
Run the CLI to upload the file, execute OCR, and write markdown output.
Use the generated markdown file in follow-up agent steps.

Run The CLI

Use npm from scripts/.

npm install
npm run build
node dist/cli.js <input-file> [--output <output-md>]

Examples:

node dist/cli.js ../sample_files/example.pdf
node dist/cli.js /any/path/to/example.pdf --output-dir ../out
node dist/cli.js ../sample_files/example.pdf --output ../out/example.md
node dist/cli.js ../sample_files/example.png --pages 0,1,2

API Key Configuration

Provide Mistral API key in this precedence order:

--api-key <key>
MISTRAL_API_KEY in environment
.env file (auto-loaded from --env-file or nearest .env in current/parent directories)

Prefer MISTRAL_API_KEY in environment for CI/automation and .env for local development.

Output Contract

Write one markdown file.

Keep page order.
Insert page separators between pages.
Preserve OCR markdown as returned by the API.
Default output path: ./ocr-output/<input-basename>.md (relative to current working directory).
Use --output for an exact file path or --output-dir for a custom output folder.

Parameters

--model <name>: OCR model (default mistral-ocr-latest)
--output-dir <path>: output directory when --output is not specified
--pages <csv>: zero-based page indexes
--keep-uploaded-file: skip cleanup of uploaded file in Mistral storage
--include-image-base64: request image payloads from OCR response

References

Read references/mistral-ocr-api.md when changing OCR request fields or response handling.

---name: mistral-ocr-markdowndescription: Convert local PDF and image files into markdown using Mistral OCR. Use when an agent needs reliable document text extraction for downstream analysis, summarization, chunking, indexing, or QA workflows where the source input is a PDF/image file and the output must be markdown.---# Mistral OCR Markdown## OverviewUse the bundled TypeScript CLI to convert one local PDF/image file into one markdown file via Mistral OCR.## Workflow1. Validate that the input file path exists and is a single local document.2. Resolve API key from CLI flag or environment.3. Run the CLI to upload the file, execute OCR, and write markdown output.4. Use the generated markdown file in follow-up agent steps.## Run The CLIUse `npm` from `scripts/`.```bashnpm installnpm run buildnode dist/cli.js <input-file> [--output <output-md>]```Examples:```bashnode dist/cli.js ../sample_files/example.pdfnode dist/cli.js /any/path/to/example.pdf --output-dir ../outnode dist/cli.js ../sample_files/example.pdf --output ../out/example.mdnode dist/cli.js ../sample_files/example.png --pages 0,1,2```## API Key ConfigurationProvide Mistral API key in this precedence order:1. `--api-key <key>`2. `MISTRAL_API_KEY` in environment3. `.env` file (auto-loaded from `--env-file` or nearest `.env` in current/parent directories)Prefer `MISTRAL_API_KEY` in environment for CI/automation and `.env` for local development.## Output ContractWrite one markdown file.- Keep page order.- Insert page separators between pages.- Preserve OCR markdown as returned by the API.- Default output path: `./ocr-output/<input-basename>.md` (relative to current working directory).- Use `--output` for an exact file path or `--output-dir` for a custom output folder.## Parameters- `--model <name>`: OCR model (default `mistral-ocr-latest`)- `--output-dir <path>`: output directory when `--output` is not specified- `--pages <csv>`: zero-based page indexes- `--keep-uploaded-file`: skip cleanup of uploaded file in Mistral storage- `--include-image-base64`: request image payloads from OCR response## ReferencesRead `references/mistral-ocr-api.md` when changing OCR request fields or response handling.

Frequently asked questions