실행 예제
완전한 예제 30개를 살펴보세요. Word 문서를 내려받거나 Python 코드를 직접 실행할 수 있습니다.
ZIP을 내려받아 압축을 풀고, examples/ 폴더가 들어 있는 위치에서 아래 명령을 실행하세요. 예제에서 사용하는 공통 모듈과 자산도 ZIP에 포함됩니다.
전체 예제를 실행하려면 LaTeX를 위해 Python 3.6.2 이상이 필요합니다. 17번 예제는 docxtpl도 사용하며 아래 설치 명령에 포함되어 있습니다.
python -m pip install "mathml2docx[latex,markdown]" "docxtpl>=0.16,<1"
python -m examples.run_all
결과는 examples/output/에 저장됩니다. 개별 예제는 python -m examples.01_quickstart처럼 실행하세요. 명령은 PyPI 배포 패키지를 사용하며, 두 언어 문서가 실행 코드를 공유합니다.
초기화된 uv·Poetry 프로젝트에서는 아래에서 사용하는 도구에 맞는 명령으로 설치·실행하세요. 프로젝트 초기화는 설치 안내를 참고하세요. 개별 예제는 examples.run_all 대신 해당 모듈 이름을 지정합니다.
uv add "mathml2docx[latex,markdown]" "docxtpl>=0.16,<1"
uv run python -m examples.run_all
poetry add "mathml2docx[latex,markdown]" "docxtpl>=0.16,<1"
poetry run python -m examples.run_all
예제를 열면 브라우저의 HTML/MathML과 LibreOffice에서 만든 PDF를 비교할 수 있습니다. Word에서 수식을 편집하려면 DOCX를 내려받으세요. 글꼴과 문서 프로그램에 따라 줄바꿈·페이지 배치가 달라질 수 있습니다.
- 빠른 시작: convert() 한 번으로 HTML을 저장하고 Document를 반환받습니다.
- 파일·인코딩·다국어: UTF-8 입력, 한글·일본어·악센트 문자와 정확한 출력 확장자를 다룹니다.
- 기존 문서와 표 셀: 기존 Document에 내용을 추가하고 셀 안에 HTML을 삽입합니다.
- 글자 서식과 색상: 굵기·기울임·밑줄·취소선·위아래 첨자·코드·반투명 색상 합성을 보여 줍니다.
- CSS 스타일시트: style 태그, 외부 CSS 로더, 선택자·상속·important 우선순위를 함께 사용합니다.
- Word 스타일과 클래스 매핑: 공개 스타일 Enum과 사용자 정의 character style을 HTML class에 연결합니다.
- 문단 배치와 페이지 나누기: 정렬·여백·들여쓰기·줄 간격과 페이지 나누기를 지정합니다.
- 표 병합과 중첩: thead·tbody, rowspan·colspan, 셀 배경, 표 폭·테두리와 중첩 표를 조합합니다.
- 목록 번호와 중첩: 시작 번호, li의 value, 독립 목록 재시작, 중첩 번호·글머리를 보여 줍니다.
- 인라인 base64 이미지: data URL 이미지를 글자 사이에 삽입하고 표시 폭을 지정합니다.
- 로컬 이미지: 명시한 기준 경로 아래의 이미지를 읽습니다. 기준 밖 경로는 허용하지 않습니다.
- 자산 로더와 이미지 직접 삽입: 논리 자산 ID를 bytes로 해석하고 BytesIO 이미지를 셀에 직접 추가합니다.
- MathML 수식: 분수·위아래 첨자·n제곱근·울타리·행렬 및 문장 안의 편집 가능한 수식을 생성합니다.
- LaTeX 수식: 선택 의존성으로 합계·분수·제곱근·행렬을 Word 수식으로 변환합니다.
- 인라인 마커와 블록 교체: 서식 run에 걸친 마커를 바꾸고 표 셀에 여러 블록을 삽입합니다.
- 북마크 교체: Word 북마크의 범위를 HTML로 교체하고 앞뒤 내용과 북마크를 보존합니다.
- docxtpl 연동: Jinja 템플릿을 렌더링한 뒤 HTML 문단을 추가합니다.
- 옵션과 설정 복사: 이미지·표·수식·서식을 끄고 설정을 독립적으로 복사합니다.
- 서식 헬퍼: 대상 run과 paragraph에 CSS 문자열을 명시적으로 적용합니다.
- 링크와 앵커: 외부 링크, 문서 내부 링크, id·name 앵커와 href 없는 링크를 다룹니다.
- 복합 보고서: 스타일시트·이미지·병합 표·중첩 목록·수식·페이지 나누기를 한 문서에 조합합니다.
- Markdown 연동: 제목·표·목록·코드와 ~~취소선~~을 선택 Markdown 프런트엔드로 변환합니다.
- 복잡한 수식 갤러리: 직접 작성한 MathML 20개와 LaTeX 24개로 중첩 분수·행렬·미분·적분·악센트·수학 글꼴을 비교합니다.
- 수식이 많은 혼합 보고서: 수식 120개와 병합·중첩 표, 목록, 이미지, 링크, 다국어 문장과 페이지 나누기를 조합합니다.
- 고급 수식 연구 보고서: 서로 다른 고급 MathML 수식 10개를 한영 본문·병합/중첩 표·목록·이미지·링크·페이지 나누기와 결합합니다.
- 고급 수식 템플릿 워크북: 고급 수식을 기존 문서와 표 셀에 넣고 마커 교체·중첩 표·머리글·바닥글·가로 페이지를 함께 사용합니다.
- 고급 LaTeX 보고서: 서로 다른 LaTeX 수식 8개로 연속 행렬·괄호 지수·조각함수·중첩 근호·합·편미분을 서식이 있는 보고서에서 검사합니다.
- 화학 표기와 수식 테두리: 정체 원소 기호·동위원소 앞 첨자·전하·반응 화살표와 기본 수식 테두리.
- MathML 복구와 이미지 대체: 지원하지 않는 원문을 표시하거나 직접 제공한 수식 이미지를 내장합니다.
- MathML 표기와 문서 보존: 속성 기본값·인라인/표시 합·복합 첨자·수식 템플릿·셀 배치·CSS·Unicode를 함께 사용합니다.