Community라이팅 & 에디팅github.com

steipete/markdown-converter

Markdown 변환: PDF, Office, HTML, 데이터, OCR, 오디오, ZIP, YouTube.

markdown-converter란 무엇인가요?

이 스킬은 `uvx markitdown` 도구를 사용하여 다양한 파일 형식을 Markdown으로 변환하는 작업을 간소화합니다. 설치가 필요 없으며 단일 명령어로 실행할 수 있어 개발자와 AI 에이전트가 문서, 미디어, 웹 데이터를 구조화된 텍스트로 쉽게 변환할 수 있습니다. PDF, Word, Excel, PowerPoint, HTML, 이미지(EXIF 및 OCR 포함), 오디오, YouTube URL, ZIP 아카이브 등 광범위한 형식을 지원합니다. 특히 Azure Document Intelligence를 활용한 고급 PDF 추출 옵션을 제공하여 복잡한 문서에서도 높은 정확도의 변환이 가능합니다. 이 스킬은 Claude Code, Cursor, Codex 등 uvx 명령어를 실행할 수 있는 모든 환경에서 작동합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/markdown-converter

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Markdown Converter

uvx markitdown을 사용하여 파일을 Markdown으로 변환합니다. 별도 설치가 필요 없습니다.

기본 사용법

# 표준 출력으로 변환
uvx markitdown input.pdf

# 파일로 저장
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# 표준 입력에서
cat input.pdf | uvx markitdown

지원 형식

  • 문서: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
  • 웹/데이터: HTML, CSV, JSON, XML
  • 미디어: 이미지 (EXIF + OCR), 오디오 (EXIF + 전사)
  • 기타: ZIP (내부 파일 반복 처리), YouTube URL, EPub

옵션

-o OUTPUT      # 출력 파일
-x EXTENSION   # 파일 확장자 힌트 (표준 입력용)
-m MIME_TYPE   # MIME 유형 힌트
-c CHARSET     # 문자셋 힌트 (예: UTF-8)
-d             # Azure Document Intelligence 사용
-e ENDPOINT    # Document Intelligence 엔드포인트
--use-plugins  # 타사 플러그인 활성화
--list-plugins # 설치된 플러그인 나열

예제

# Word 문서 변환
uvx markitdown report.docx -o report.md

# Excel 스프레드시트 변환
uvx markitdown data.xlsx > data.md

# PowerPoint 프레젠테이션 변환
uvx markitdown slides.pptx -o slides.md

# 파일 유형 힌트와 함께 변환 (표준 입력용)
cat document | uvx markitdown -x .pdf > output.md

# Azure Document Intelligence를 사용한 향상된 PDF 추출
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"

참고 사항

  • 출력 시 문서 구조(제목, 표, 목록, 링크)가 유지됩니다.
  • 첫 실행 시 종속성을 캐싱하며, 이후 실행은 더 빠릅니다.
  • 추출이 어려운 복잡한 PDF의 경우 -d 옵션과 함께 Azure Document Intelligence를 사용하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

관련 스킬