Communitygithub.com

zhangys11/agent-skills

재사용 가능한 에이전트 스킬(SKILL.md) 모음. 마크다운을 LaTeX 논문용 .tex 파일로 변환하는 md2tex 스킬을 포함합니다.

agent-skills란 무엇인가요?

Markdown to LaTeX Converter (md2tex)는 AI 코딩 에이전트(Claude Code, Cursor, Codex 등)가 학술 마크다운 원고를 LaTeX .tex 파일로 변환할 수 있게 해주는 스킬입니다. 헤더, 굵게/기울임, 파이프 테이블, 이미지, 수식, 글머리 기호 목록, 유니코드 특수 문자, 인용 형식 등 전체 변환 파이프라인을 처리합니다. article(기본값), revtex(Physical Review 저널), ieeetran(IEEE 트랜잭션) 등 다양한 문서 클래스 프리셋을 지원하며, 사용자 정의 프리앰블로 패키지와 명령어를 추가할 수 있습니다. 인용 처리는 BibTeX 키 유지 또는 thebibliography 삽입 중 선택 가능하고, --compile 플래그로 PDF까지 자동 컴파일할 수 있습니다. 복잡한 중첩 목록, 코드 블록, 각주 등 일부 요소는 수동 조정이 필요할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add zhangys11/agent-skills

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

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

미리보기

스킬 README에서

alt

문서

Markdown to LaTeX 변환기 (md2tex)

학술 마크다운 원고를 저널 투고에 적합한 LaTeX .tex 파일로 변환합니다. 헤더, 굵게/기울임, 파이프 테이블, 이미지, 디스플레이/인라인 수식, 글머리 기호 목록, 유니코드 특수 문자, 인용 형식 등 전체 변환 파이프라인을 처리합니다.

빠른 시작

# 간단: 단일 .md 파일을 article 클래스 .tex으로 변환
python3 scripts/md2tex.py paper.md -o output/

# 문서 클래스 프리셋 선택
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex

# 여러 파일: 주 원고 + 부록을 보충 자료로 변환
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex

# 사용자 정의 프리앰블 덮어쓰기 (패키지, 명령어 등 추가)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/

# 생성 후 PDF 컴파일
python3 scripts/md2tex.py paper.md -o output/ --compile

위 경로는 이 스킬의 기본 디렉터리를 기준으로 합니다.

기능

스크립트는 마크다운을 읽고 다음 변환을 적용하여 LaTeX을 생성합니다.

마크다운LaTeX
## 섹션\section{섹션}
### 하위섹션\subsection{하위섹션}
#### 하위하위섹션\subsubsection{하위하위섹션}
**굵게**\textbf{굵게}
*기울임*\textit{기울임} (수학 인식: $...$ 건너뜀)
$$...$$$$...$$ (통과)
$...$$...$ (통과)
| ... | 파이프 테이블\begin{tabular}...\end{tabular}
![alt](경로)\begin{figure}\includegraphics...\caption...\end{figure}
`![[경로대체텍스트]]` (옵시디언)
- 항목\begin{itemize}\item...\end{itemize}
α, β, ∞, →, × 등$\alpha$, $\beta$, $\infty$, $\to$, $\times$
--- (줄표)--- (보존)

추가 처리

  • 이미지 캡션: 이미지 뒤에 **Fig. N | ...** 또는 **Fig. N.** 줄이 오는지 확인하여 적절한 \caption{...}을 만듭니다.
  • 표 캡션: 파이프 테이블 앞에 **Table N | ...** 또는 **TABLE N** 블록이 있는지 확인합니다.
  • 유니코드 수학: α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬를 LaTeX 등가물로 매핑합니다.
  • 악센트 문자: é è ê ñ ö ü â î ô를 LaTeX 이스케이프로 매핑합니다.
  • 똑똑한 따옴표: "" ''을 `` ''로 변환합니다.
  • 폴란드어 ł: Białynicki → Bia{\l}ynicki로 올바르게 표시합니다.
  • 빈 줄 정리: 4개 이상의 빈 줄을 2개로 줄입니다.
  • 인용 블록 제거: 선택적으로 > ... 줄을 제거합니다.

문서 클래스 프리셋

프리셋문서 클래스사용 사례
article (기본값)\documentclass[12pt]{article}일반 논문, arXiv
revtex\documentclass[aps,pra,preprint]{revtex4-2}Physical Review 저널
ieeetran\documentclass[journal,onecolumn,12pt]{IEEEtran}IEEE 트랜잭션

각 프리셋에는 적절한 패키지(graphicx, amsmath, amssymb, hyperref, booktabs, array)가 포함됩니다.

사용자 정의 프리앰블

전체 프리앰블(패키지, 명령어 등)이 포함된 .tex 파일을 만들고 --preamble로 전달하세요. 각 프리셋의 기본값이 덮어쓰여집니다.

예시 my_preamble.tex:

\documentclass[aps,pra,reprint]{revtex4-2}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{hyperref}
\usepackage{booktabs}
\usepackage{xcolor}
\newcommand{\pbox}[2]{\parbox{#1}{\vspace{4pt}\RaggedRight #2\vspace{4pt}}}

인용 처리

--cite로 설정하는 두 가지 모드:

bibtex (기본값)

텍스트에 BibTeX 키를 유지: \cite{key2020}. 기본적으로 참고문헌 섹션 또는 참고문헌 파일에서 인용 키를 읽습니다. [N] 스타일 인용 자리표시자는 --cite-map이 제공되지 않는 한 그대로 둡니다.

inline

수동으로 작성된 항목과 함께 \begin{thebibliography}...\end{thebibliography}를 삽입합니다. 참고문헌 내용을 제공하려면 --biblio references.tex와 함께 사용하세요.

고급 옵션

--title "논문 제목"     문서 제목 덮어쓰기 (기본값: 첫 번째 # 헤더)
--author "이름"           저자 이름
--affiliation "소속"      저자 소속
--email "[email protected]"      교신 저자 이메일
--abstract                ## 초록 섹션에서 초록 추출 (기본값: 자동)
--no-abstract             초록 추출 건너뛰기
--appendix 부록.md        부록을 보충 자료로 변환
--suppress-numbers       \section*{} 사용 (번호 없음, 보충 자료용)
--cite-map map.json      인용 자리표시자의 BibTeX 키 매핑 JSON
--compile                생성 후 pdflatex 두 번 실행
--fig-dir figures/       그림을 복사할 디렉터리 (기본값: 자동 감지)
--help                   전체 사용법 보기

컴파일 힌트

.tex 파일 생성 후 다음과 같이 컴파일하세요:

# REVTeX (revtex4-2.cls 설치 필요)
cd output/ && pdflatex main.tex && pdflatex main.tex

# IEEEtran (IEEEtran.cls 설치 필요)
cd output/ && pdflatex main.tex && pdflatex main.tex

스크립트는 마크다운에서 참조된 그림을 자동 감지하여 소스 디렉터리에서 출력 디렉터리로 복사합니다.

제한 사항

  • 범용 변환기가 아님: 학술 논문 구조(IMRaD + 보충 자료)용으로 설계되었습니다. 복잡한 중첩 목록, 코드 블록, 각주는 수동 조정이 필요할 수 있습니다.
  • 파이프 테이블만 지원: HTML <table> 태그는 변환되지 않습니다.
  • 단일 수준 글머리 기호: 현재 2단계 중첩을 처리하며, 더 깊은 목록은 평탄화될 수 있습니다.
  • 수학 환경: \begin{aligned}...\end{aligned} 등은 변경 없이 통과됩니다. 유효한 LaTeX인지 확인하세요.
  • 인용 변환: [N]을 \cite{}로 변환하려면 사용자 제공 매핑 파일 또는 수동 후처리가 필요합니다.
  • 실시간 새로고침 없음: 각 .md 편집 후 .tex을 재생성해야 합니다. 스킬이 파일을 감시하지 않습니다.

옵시디언 스타일 PDF 렌더링(A4, Arial, MathJax)을 원하면 obsidian-pdf 스킬을 대신 사용하세요.

관련 스킬