OpenParable
Skip to content
← Back to skills

Markit

Documents
markit

Markit is an Agent Skill for documents published in the Michaelliv/markit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Convert files and URLs to Markdown. Supports PDF, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON, GitHub URLs, images, audio, ZIP, and more. Use when you need to extract content from any document format.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Michaelliv/markit/blob/HEAD/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/markit, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

markit

Convert anything to Markdown.

CLI

# Convert a file
npx markit-ai report.pdf -q

# Convert a URL
npx markit-ai https://en.wikipedia.org/wiki/Markdown -q

# GitHub URLs (repos, files, gists, issues, PRs)
npx markit-ai https://github.com/owner/repo -q
npx markit-ai https://github.com/owner/repo/issues/42 -q
npx markit-ai https://gist.github.com/user/id -q

# Write to file
npx markit-ai document.docx -q -o output.md

# See all options
npx markit-ai --help

# See supported formats
npx markit-ai formats

-q gives raw markdown. --json gives { markdown, title }.

SDK

import { Markit } from "markit-ai";

const markit = new Markit();
const { markdown } = await markit.convertFile("report.pdf");
const { markdown } = await markit.convertUrl("https://example.com");
const { markdown } = await markit.convert(buffer, { extension: ".docx" });