Communitygithub.com

bowenliang123/markdown-exporter

마크다운을 DOCX, PPTX, XLSX, PNG, PDF, HTML, MD, CSV, JSON, XML 등 다양한 포맷의 파일로 변환하는 Agent Skill 및 Dify 플러그인입니다.

markdown-exporter란 무엇인가요?

Markdown Exporter는 마크다운 텍스트를 다양한 전문 포맷의 파일로 변환해주는 Agent Skill입니다. 개발자와 AI 에이전트 사용자는 이 스킬을 통해 마크다운 콘텐츠를 문서(DOCX), 프레젠테이션(PPTX), 스프레드시트(XLSX), 이미지(PNG, SVG), PDF, HTML, XML, JSON, LaTeX 등으로 손쉽게 내보낼 수 있습니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 Dify에서 사용할 수 있으며, CLI 도구와 Python 패키지(md-exporter)로도 제공됩니다. 각 변환 명령어는 파일 경로를 인자로 받아 동작하며, 명령어별로 템플릿 지정, 멀티 페이지 출력, JSON 스타일 선택 등 다양한 옵션을 지원합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add bowenliang123/markdown-exporter
원본 보기→모든 스킬 둘러보기

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

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

문서

Markdown Exporter

Markdown Exporter는 마크다운 텍스트를 다양한 전문 포맷 파일로 변환하는 Agent Skill입니다.

이 SKILL.md는 Agent Skill, CLI 도구, Python 패키지 markdown-exporter와 함께 GitHub 저장소 bowenliang123/markdown-exporter에서 bowenliang123이 관리하고 있습니다.

도구 및 지원 포맷

도구입력 (마크다운 텍스트 또는 스타일 파일 경로)출력 (내보낸 파일 경로)
md_to_docx📝 마크다운 텍스트📄 Word 문서 (.docx)
md_to_html📝 마크다운 텍스트🌐 HTML 파일 (.html)
md_to_html_text📝 마크다운 텍스트🌐 HTML 텍스트 문자열
md_to_jira📝 마크다운 텍스트🅹 Jira 위키 마크업 텍스트
md_to_pdf📝 마크다운 텍스트📑 PDF 파일 (.pdf)
md_to_png📝 마크다운 텍스트🖼️ PNG 이미지 (.png), 단일 긴 페이지 또는 페이지당 하나의 이미지
md_to_svg📝 마크다운 텍스트🖼️ SVG 이미지 (.svg), 페이지당 하나의 이미지
md_to_md📝 마크다운 텍스트📝 마크다운 파일 (.md)
md_to_ipynb📝 마크다운 텍스트📓 Jupyter 노트북 (.ipynb)
md_to_pptx📝 Pandoc 스타일 마크다운 슬라이드🎯 PowerPoint (.pptx)
md_to_xlsx📋 마크다운 테이블📊 Excel 스프레드시트 (.xlsx)
md_to_csv📋 마크다운 테이블📋 CSV 파일 (.csv)
md_to_json📋 마크다운 테이블📦 JSON/JSONL 파일 (.json)
md_to_xml📋 마크다운 테이블🏷️ XML 파일 (.xml)
md_to_latex📋 마크다운 테이블📝 LaTeX 파일 (.tex)
md_to_codeblock💻 마크다운 코드 블록📁 언어별 코드 파일 (.py, .js, .sh 등)

📦 사용법

개요

Markdown Exporter는 PyPI 패키지로 제공되며, 모든 기능에 대한 원활한 명령줄 인터페이스를 제공합니다.

설치

# pip 사용
pip install md-exporter

# uv 사용
uv tool install md-exporter

# OpenClaw 사용
npx clawhub install markdown-exporter

markdown-exporter 명령어와 사용법 확인:

markdown-exporter -h

markdown-exporter <subcommand> -h

기본 사용법

모든 도구에 접근하려면 markdown-exporter 명령어를 사용하세요:

markdown-exporter <subcommand> <args> [options]

중요 참고 사항

  • 모든 명령어는 파일 경로만 입력으로 지원합니다.
  • 패키지가 모든 종속성 관리를 자동으로 처리합니다.
  • 프로젝트 디렉토리로 이동할 필요 없이 시스템의 어디에서나 명령어를 실행할 수 있습니다.

🔧 스크립트

md_to_csv - 마크다운 테이블을 CSV로 변환

마크다운 테이블을 CSV 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_csv <input> <output> [options]

인자:

  • input - 테이블이 포함된 입력 마크다운 파일 경로
  • output - 출력 CSV 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_csv /path/input.md /path/output.csv

    입력 마크다운 파일의 모든 테이블을 CSV 형식으로 변환합니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_csv /path/input.md /path/output.csv --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_pdf - 마크다운을 PDF로 변환

중국어, 일본어 및 기타 언어를 지원하여 마크다운 텍스트를 PDF 형식으로 변환합니다.

사용법:

markdown-exporter md_to_pdf <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 PDF 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_pdf /path/input.md /path/output.pdf

    전체 마크다운 파일을 PDF 문서로 변환합니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_pdf /path/input.md /path/output.pdf --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_png - 마크다운을 PNG로 변환

중국어, 일본어 및 기타 언어를 지원하여 마크다운 텍스트를 PNG 이미지로 변환합니다.

사용법:

markdown-exporter md_to_png <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 PNG 파일 경로

옵션:

  • --multi-page - 단일 긴 페이지 PNG 대신 A4 페이지당 하나의 PNG (번호가 매겨진 파일)로 내보내기
  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환 (단일 긴 페이지 이미지):

    markdown-exporter md_to_png /path/input.md /path/output.png

    전체 마크다운 문서를 단일 긴 페이지 PNG 이미지로 렌더링합니다.

  2. 멀티 페이지 출력:

    markdown-exporter md_to_png /path/input.md /path/output.png --multi-page

    문서에 여러 페이지가 있는 경우 A4 페이지당 하나의 PNG로 내보내고 output_1.png, output_2.png 등으로 저장합니다.

  3. 코드 블록 래퍼 제거:

    markdown-exporter md_to_png /path/input.md /path/output.png --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_svg - 마크다운을 SVG로 변환

중국어, 일본어 및 기타 언어를 지원하여 마크다운 텍스트를 SVG 이미지로 변환하며, 페이지당 하나의 SVG를 생성합니다.

사용법:

markdown-exporter md_to_svg <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 SVG 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_svg /path/input.md /path/output.svg

    마크다운 파일을 SVG 이미지로 변환하며, 문서에 여러 페이지가 있는 경우 output_1.svg, output_2.svg 등으로 저장합니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_svg /path/input.md /path/output.svg --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_docx - 마크다운을 DOCX로 변환

마크다운 텍스트를 DOCX 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_docx <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 DOCX 파일 경로

옵션:

  • --template - DOCX 템플릿 파일 경로 (선택 사항)
  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_docx /path/input.md /path/output.docx

    전체 마크다운 파일을 DOCX 문서로 변환합니다.

  2. 사용자 정의 템플릿 사용:

    markdown-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx

    스타일링을 위해 사용자 정의 DOCX 템플릿을 사용합니다.

  3. 코드 블록 래퍼 제거:

    markdown-exporter md_to_docx /path/input.md /path/output.docx --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_xlsx - 마크다운 테이블을 XLSX로 변환

여러 시트를 지원하여 마크다운 테이블을 XLSX 형식으로 변환합니다.

사용법:

markdown-exporter md_to_xlsx <input> <output> [options]

인자:

  • input - 테이블이 포함된 입력 마크다운 파일 경로
  • output - 출력 XLSX 파일 경로

옵션:

  • --force-text - 셀 값을 텍스트 유형으로 변환 (기본값: True)
  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx

    입력 마크다운 파일의 모든 테이블을 XLSX 통합 문서로 변환하며, 각 테이블은 별도의 시트에 배치됩니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

  3. force-text 비활성화:

    markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --force-text False

    Excel이 셀 유형을 자동으로 결정하도록 허용합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_pptx - 마크다운을 PPTX로 변환

마크다운 텍스트를 PPTX 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_pptx <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 PPTX 파일 경로

옵션:

  • --template - PPTX 템플릿 파일 경로 (선택 사항)

예제:

  1. 기본 변환:

    markdown-exporter md_to_pptx /path/input.md /path/output.pptx

    마크다운 파일을 PowerPoint 프레젠테이션으로 변환합니다.

  2. 사용자 정의 템플릿 사용:

    markdown-exporter md_to_pptx /path/input.md /path/output.pptx --template /path/template.pptx

    스타일링을 위해 사용자 정의 PowerPoint 템플릿을 사용합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 슬라이드 (PPTX용) 섹션의 "슬라이드 (PPTX용)" 예제를 사용하세요.

md_to_codeblock - 코드 블록을 파일로 추출

마크다운에서 코드 블록을 추출하여 개별 파일로 저장합니다.

사용법:

markdown-exporter md_to_codeblock <input> <output> [options]

인자:

  • input - 코드 블록이 포함된 입력 마크다운 파일 경로
  • output - 출력 디렉토리 경로 또는 ZIP 파일 경로

옵션:

  • --compress - 모든 코드 블록을 ZIP 파일로 압축

예제:

  1. 디렉토리로 추출:

    markdown-exporter md_to_codeblock /path/input.md /path/output_dir

    모든 코드 블록을 지정된 디렉토리의 개별 파일로 추출합니다.

  2. ZIP 파일로 추출:

    markdown-exporter md_to_codeblock /path/input.md /path/output.zip --compress

    모든 코드 블록을 추출하여 ZIP 파일로 압축합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 코드 블록 섹션의 "코드 블록" 예제를 사용하세요.

md_to_json - 마크다운 테이블을 JSON으로 변환

마크다운 테이블을 JSON 또는 JSONL 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_json <input> <output> [options]

인자:

  • input - 테이블이 포함된 입력 마크다운 파일 경로
  • output - 출력 JSON 파일 경로

옵션:

  • --style - JSON 출력 스타일: jsonl (기본값) 또는 json_array
  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환 (JSONL 형식):

    markdown-exporter md_to_json /path/input.md /path/output.json

    테이블을 JSON Lines 형식(줄당 하나의 JSON 객체)으로 변환합니다.

  2. JSON 배열로 변환:

    markdown-exporter md_to_json /path/input.md /path/output.json --style json_array

    테이블을 단일 JSON 객체 배열로 변환합니다.

  3. 코드 블록 래퍼 제거:

    markdown-exporter md_to_json /path/input.md /path/output.json --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_xml - 마크다운을 XML로 변환

마크다운 텍스트를 XML 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_xml <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 XML 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_xml /path/input.md /path/output.xml

    전체 마크다운 파일을 XML 문서로 변환합니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_xml /path/input.md /path/output.xml --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_latex - 마크다운 테이블을 LaTeX로 변환

마크다운 테이블을 LaTeX 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_latex <input> <output> [options]

인자:

  • input - 테이블이 포함된 입력 마크다운 파일 경로
  • output - 출력 LaTeX 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_latex /path/input.md /path/output.tex

    마크다운 파일의 테이블을 LaTeX 형식 파일로 변환합니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_latex /path/input.md /path/output.tex --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 기본 텍스트 및 테이블 섹션의 "기본 텍스트 및 테이블" 예제를 사용하세요.

md_to_ipynb - 마크다운을 Jupyter 노트북으로 변환

마크다운 텍스트를 Jupyter 노트북(.ipynb) 형식 파일로 변환합니다.

사용법:

markdown-exporter md_to_ipynb <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 IPYNB 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환:

    markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb

    마크다운 파일을 Jupyter 노트북 형식으로 변환합니다.

  2. 코드 블록 래퍼 제거:

    markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb --strip-wrapper

    마크다운을 처리하기 전에 코드 블록 래퍼(```)를 제거합니다.

샘플 마크다운 입력: 아래 샘플 마크다운 입력 - 코드 블록 섹션의 "코드 블록" 예제를 사용하세요.

md_to_jira - 마크다운을 Jira 위키 마크업으로 변환

마크다운 텍스트를 Jira 위키 마크업 형식으로 변환합니다.

사용법:

markdown-exporter md_to_jira <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 텍스트 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환: 
    markdown-exporter md_to_jira /path/input.md /path/output.txt
    마크다운 파일을 Jira 위키 마크업 텍스트로 변환합니다.

md_to_html_text - 마크다운을 HTML 텍스트로 변환

마크다운 텍스트를 HTML 텍스트 문자열로 변환합니다.

사용법:

markdown-exporter md_to_html_text <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 텍스트 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거

예제:

  1. 기본 변환: 
    markdown-exporter md_to_html_text /path/input.md /path/output.html_text
    마크다운 파일을 HTML 텍스트 문자열로 변환합니다.

md_to_md - 마크다운 정리

마크다운 파일을 정리하여 저장합니다. 코드 블록 래퍼를 제거하는 데 유용합니다.

사용법:

markdown-exporter md_to_md <input> <output> [options]

인자:

  • input - 입력 마크다운 파일 경로
  • output - 출력 마크다운 파일 경로

옵션:

  • --strip-wrapper - 코드 블록 래퍼가 있는 경우 제거 (기본값: True)

예제:

  1. 코드 블록 래퍼 제거: 
    markdown-exporter md_to_md /path/input.md /path/output.md --strip-wrapper
    코드 블록 래퍼를 제거하여 마크다운 파일을 정리합니다.

📋 샘플 마크다운 입력

샘플 마크다운 입력은 Markdown Exporter 리포지토리의 examples/ 디렉토리를 참조하세요.

기본 텍스트 및 테이블

examples/basic-text-tables.md 파일:

# 헤더 1

본문 내용입니다.

| 헤더 1 | 헤더 2 | 헤더 3 |
|--------|--------|--------|
| 셀 1   | 셀 2   | 셀 3   |
| 셀 4   | 셀 5   | 셀 6   |

## 헤더 2

| 헤더 A | 헤더 B |
|--------|--------|
| 데이터 1 | 데이터 2 |
| 데이터 3 | 데이터 4 |

슬라이드 (PPTX용)

examples/slides.md 파일:

# 프레젠테이션 제목

작성자 이름

---

# 첫 번째 슬라이드

- 포인트 1
- 포인트 2
- 포인트 3

---

# 두 번째 슬라이드

| 열 1 | 열 2 |
|------|------|
| 데이터 | 데이터 |

코드 블록

examples/code-blocks.md 파일:

# 예제

다음은 Python 함수입니다:

```python
def greet(name):
    return f"안녕하세요, {name}!"

다음은 JavaScript 함수입니다:

function greet(name) {
    return `Hello, ${name}!`;
}


## 🤝 기여

기여를 환영합니다! 자세한 내용은 [CONTRIBUTING.md](https://github.com/bowenliang123/markdown-exporter/blob/main/CONTRIBUTING.md)를 참조하세요.

## 📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.

관련 스킬

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community