API와 옵션

python -m pip install mathml2docx로 설치하세요. LaTeX·Markdown 선택 의존성은 시작하기에서 설명합니다.

공개 API

from mathml2docx import convert, MathmlToDocx, TableStyle, ParagraphStyle

convert('<p>내용</p>', 'output.docx', paragraph_style=ParagraphStyle.NORMAL)
parser = MathmlToDocx(table_style=TableStyle.GRID)

HtmlToDocx도 기존 이름으로 제공하며, 새 코드에는 MathmlToDocx를 권장합니다.

메서드 결과
convert(html, output=None, **options) Document 반환, 출력 경로가 있으면 저장
parser.convert(html, output=None) 현재 설정으로 변환
parse_html_string(html) 새 Document 반환
parse_html_file(input, output=None, encoding='utf-8') 저장한 Path 반환. 확장자는 한 번만 추가
parse_mathml(source) 네이티브 OMML 수식이 든 Document 반환
parse_markdown(source) 선택 의존성 Markdown으로 제목·표·코드·취소선 변환
parse_latex(source) 선택 의존성 latex2mathml로 변환한 Document 반환. Python 3.6.2 이상 필요
add_html_to_document(html, document) Document·표 셀·DocxTemplate에 추가
add_html_to_cell(html, cell) 표 셀에 추가
add_image_to_cell(cell, image) BytesIO 이미지를 문서·셀에 추가
copy_settings_from(other) 모든 옵션·스타일 매핑 독립 복사
replace_html(document, marker, html) 여러 run에 걸친 고유 마커를 인라인·블록 HTML로 교체
replace_bookmark(document, name, html) 북마크 범위를 HTML로 교체
get_origin() 현재 변환기 반환

생성자 옵션

인자 기본값 동작
fix_html True 호환용 인자. 트리 파싱은 항상 수행
images True 이미지 처리 여부
tables True 표 처리 여부
mathml True MathML 처리 여부
styles True 인라인 서식 처리 여부
img_src_base_path None 이 경로 아래의 로컬 이미지만 허용
image_loader None 자산 출처를 받아 bytes·파일 객체를 반환하는 명시적 콜백
table_style None Word 표 스타일 이름 또는 TableStyle 값
paragraph_style None Word 문단 스타일 이름 또는 ParagraphStyle 값
stylesheet "" 추가 CSS 스타일시트 문자열
stylesheet_loader None 외부 CSS 경로를 받아 CSS 문자열을 반환하는 명시적 콜백
style_map None 태그 → class → Word 스타일 이름 매핑
default_math_display 'inline' MathML의 display를 생략했을 때 배치. 'block'으로 이전 배치 선택
unsupported_math 'error' 'error'는 예외 발생, 'text'는 미지원 수식의 전체 XML 표시
mathml_preprocessor None 완전한 MathML 문자열을 받아 반환하는 콜백
mathml_fallback None (source, error)를 받아 텍스트·이미지 바이트·BytesIO를 반환하는 콜백
math_target 'word' 'libreoffice'는 정체 식별자를 명시하고 표시 손실이 알려진 표기를 대체 처리

생성 후 parser.options.images = False로 설정을 변경할 수 있습니다. 표·문단 스타일과 매핑은 parser.table_style, parser.paragraph_style, parser.style_map에 설정합니다. 사용하는 Word 템플릿에 해당 스타일이 있어야 합니다.

기본 이미지 로더는 data URL과 명시한 로컬 기준 경로만 처리합니다. URL 다운로드는 자동으로 하지 않습니다. image_loader에서 네트워크를 사용한다면 호출자가 대상·크기· 시간 제한을 적용해야 합니다.

수식·CSS 지원 범위와 호환성 변경은 마이그레이션 문서를 참고하세요.

전체 실행 코드는 예제 모음, 기능별 조합은 작업별 사용법을 참고하세요.

수식 배치·테두리·화학 표기·미지원 입력 처리를 참고하세요.