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} |
 | \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 스킬을 대신 사용하세요.