원본 프로젝트 이슈 호환성

mathml2docx는 pqzx/html2docx에서 파생됐습니다. 이 기록은 원본 프로젝트의 이슈 49건(PR 제외, 열린 이슈와 닫힌 이슈)을 1.0 변환기의 동작과 연결합니다. 검토 스냅샷은 2026-11-09 기준이며 아래 표에서 재현 근거·수정 내용·입력별 한계를 확인할 수 있습니다. 사용 질문과 관리 요청은 변환기 결함과 구분합니다. 구조 검사와 문서 프로그램 표시 검사의 차이는 검증 안내를 참고하세요.

기존 수정 검증

1.0 이전 구현의 기준 커밋 89205f4을 임시 경로로 복원해 tests/test_existing_fixes.py의 6개 테스트를 실행했습니다. base64/인라인 이미지, src 누락, 선행 br, UTF-8/문단 스타일, 내용이 있는 rowspan, 기본 글자 서식은 모두 통과했습니다. 동일 테스트를 1.0 변환기에서도 실행합니다.

기존 동작과 회귀 검사

tests/test_regressions.py의 9개 테스트 중 기존 코드에서 오류 4개와 실패 1개를 먼저 확인했습니다. 새 엔진에서는 통과합니다. 추가 공개 API·수식·보안·병합·목록·템플릿 검증은 tests/test_v1.py에 있습니다. XML 및 관계 검증이며 Word 화면의 시각적 검증은 아닙니다.

이슈 판정 근거·제약
#1 failed to convert html table to docx 검증 tbody 및 중첩 표를 포함한 기존 데이터셋 통과.
#2 Conversion of <ol><li>: No style with name 'List Number' 수정 목록 번호 XML 직접 생성으로 List Number 스타일 존재 여부와 무관하게 동작.
#3 Errno 36] File name too long: 'data:image/png;base64,iVBOR 기존 수정 검증 base64 이미지 처리.
#4 Does it support css styles? 지원 구현 style 태그·정적 CSS 선택자·specificity·상속·important 및 명시적 외부 CSS 로더 구현. 대응 Word 속성 범위는 사용법 표에 명시.
#6 IndexError: list index out of range 원본 입력 검증 원문 FILE.txt를 변환·저장하고 LibreOffice PDF 렌더링 완료. 표 데이터는 병합 회귀 테스트와 함께 검증.
#10 Issue with float margins and named (vs RGB) colors 수정·검증 실수 길이와 named color 처리.
#12 <img src="data:image/png;base64,xxxx==> 기존 수정 검증 base64 PNG 이미지 처리.
#13 ValueError: invalid literal for int() with base 10: 'r' 검증 hr과 제목 태그를 별도로 처리. 기존 hr 테스트도 통과.
#14 Renders as more or less plain text 원본 입력 검증 이슈 본문의 Qt HTML 5,660자를 변환·렌더링. 글꼴·크기·색상·굵기 보존. p를 글꼴 크기만 보고 Heading으로 추측하지는 않음.
#15 HTML Tag <a href=... 검증 링크 텍스트와 관계를 DOCX 저장 후 재오픈해 검증. 구버전 python-docx의 paragraph.text 표시는 별개.
#21 Color conversion not done when a text is in bold or italic 수정 bold/italic 태그에도 CSS 색상 상속·적용.
#22 Tweak to handle links without href 수정 href 없는 링크의 텍스트 유지.
#25 Create document from Word template 기능 구현·검증 기존 Word 템플릿, 여러 run의 인라인 마커, 문단 간 북마크 범위 교체 지원. 앞뒤 run 서식과 북마크 보존 테스트.
#27 UnicodeDecodeError: how to convert html documents with accented characters? 기존 수정 검증 비ASCII UTF-8 파일 읽기.
#28 Code breaks for base64 image source, saying OSError: [Errno 36] File name too long 기존 수정 검증 base64 이미지 처리.
#30 <title> attribute should be rendered with the MS Word "Title" style 기능 추가 title을 Word Title 문단으로 처리.
#31 Addin page breaks? 기능 추가 page-break-before/after 및 break-before/after.
#32 parse_dict_string raising excemptions in edge cases 수정 tinycss2 파서로 URL의 콜론·따옴표·공백 보존.
#33 Tab_stops 지원·예제 pre 탭 보존 검증. Word 스타일에서 탭 정지·점선 리더를 설정하는 실행 코드를 작업별 사용법에 제공.
#35 Suggestion for HTML class to Word style mapping 기능 추가 p class -> Quote 매핑 검증; 인라인 class는 character style 이름 사용.
#36 Add support for DocxTemplate fom docxtpl package 기능 구현·검증 실제 docxtpl Jinja 치환 후 HTML 추가·저장·재오픈 검증. 렌더링한 내용을 get_docx 재초기화로 잃던 추가 결함도 수정.
#37 'HtmlToDocx' object has no attribute 'run' 구조 수정·검증 파서의 공유 run 상태 의존을 제거. 선행 br, 이미지, 링크, 빈 입력·셀 경로를 회귀 테스트. 원문 입력은 공개되지 않아 동일 입력 비교는 불가.
#38 Getting IndexError: list index out of range when parsing wikipedia page 현재 실제 입력 검증 동일 Wikipedia URL의 현재 HTML 2,481,297바이트에서 표 28개·문단 626개 생성 및 PDF 렌더링. 2022년 스냅샷 자체는 없음.
#40 Nested Ordered list not working correctly 원본 입력 검증 원문 첨부 HTML로 PDF 렌더링 완료. 시작 번호·재시작·중첩 깊이·li value 및 번호 뒤 간격을 예제로 검증.
#41 Add the ability to make bold, italics and Underline. Also, can you look into adding superscripts and subscripts? 기존 수정 검증 b/i/sup/sub 서식 검증.
#42 Background Color is Not working 수정 실제 RGB 배경색을 w:shd fill로 기록.
#43 table_style = 'TableGrid' 수정 TableGrid 별칭 및 공개 TableStyle.GRID 제공.
#44 Converting block level elements like <div> into paragraphs 수정 div/section 등 블록을 문단으로 처리.
#46 Add classes with specific styles 기능 추가 태그·class별 Word style_map.
#47 Release Latest Version, so we can use paragraph_style support mathml2docx 1.0.0에 포함 PyPI에 배포한 mathml2docx에 문단 스타일을 포함합니다. upstream html2docx의 릴리스나 게시 권한을 변경하는 것은 아닙니다.
#48 Unable to convert html with rowspan to docx correctly 기존 수정 검증·보강 Phone 행 병합은 기존 코드 통과. 새 코드는 빈 셀 병합까지 검증.
#49 margin handler cannot handle percentages 수정 %와 실수 길이 처리; %는 문서 본문 가용 폭 기준.
#50 Including tables 검토 보고자가 잘못된 HTML로 철회. 추가 재현 요구 없음.
#51 "IndexError: list index out of range" when using colspan attribute 수정 colspan을 반영해 열 수 계산; 빈 병합 셀도 위치 추적.
#52 How can I render HTML-file content to specific tag/word into a template.docx file (word replacement)? 기능 구현·검증 문장 중간·여러 run·표 셀의 마커, 단일·다중 문단 북마크를 HTML로 교체. 삽입 링크·이미지·수식의 문서 관계와 앞뒤 내용 보존.
#54 "IndexError: list index out of range" when using rowspan attribute 수정 본문의 Country/Dhaka/Sylhet 예제로 병합 위치와 텍스트 검증.
#55 'gbk' codec can't decode byte 0xac in position 1024: illegal multibyte sequence 기존 수정 검증 명시적 UTF-8 파일 읽기 및 encoding 인자.
#57 Poor Performance for Large Tables 수정·측정 표 셀 배열을 한 번 생성; 반복 Table.cell 호출 제거. 아래 측정 참고.
#60 img without src will crash 기존 수정 검증 src 없는 img가 예외 없이 처리됨.
#61 ImportError: cannot import name 'OxmlElement' from 'docx.oxml' 검증 지원 의존성 범위에서 import 및 문서 생성 검증; 모든 과거 버전 조합을 보장하지 않음.
#62 parser crash with a tag without href 수정 href 없는 a의 텍스트 보존.
#66 [bug] tables containing a <td> whose first child is <br> results in a crash 기존 수정 검증 셀 첫 자식 br 뒤 텍스트 유지.
#67 handling base64 image 기존 수정 검증 data URL PNG를 실제 DOCX 이미지로 변환.
#68 Underline not converting into docx 수정 CSS text-decoration:underline 지원.
#70 ValueError: invalid literal for int() with base 10: '0.88' 수정·검증 RGBA 소수 알파 예외 제거 및 상위 배경색과 실제 RGB 합성. 빨강 50%와 파랑 배경의 보라색 결과를 검증.
#71 Images are not positioned correctly in the resulting DOCX file 원본 이미지 포함 검증 원문 HTML의 공개 이미지 6개를 명시적 로더로 읽어 DOCX에 삽입하고 PDF 렌더링. 인라인 배치·CSS 크기와 앞뒤 텍스트 보존을 별도 회귀 테스트.
#74 Issue with Ordered List Numbering and Strikethrough Rendering in DOCX 수정·프런트엔드 추가 목록별 번호 재시작. parse_markdown()에서 표·코드·~~취소선~~ 기본 지원. 코드 안의 ~~ 보존과 실제 Word 취소선 속성을 검증.
#75 I continued this project on other repo 안내 후속 프로젝트 소개로 제품 결함 아님.
#78 Security: please enable private vulnerability reporting 코드 수정·외부 조치 구분 변환기의 암묵적 HTTP·CSS 로딩 제거 및 로컬 기준 경로 제한 검증. 명시적 로더만 허용. upstream Private Vulnerability Reporting 설정 변경은 소유자 권한 필요.

표 성능 측정

같은 Python 3.14 환경에서 300행×3열의 단순 텍스트 표를 1회씩 변환했습니다. 변경 전 10.128초, 변경 후 0.057초였습니다. HTML 구성·환경에 따라 결과는 달라집니다. 이 수치는 단일 측정이며 성능 보장이나 모든 종류의 병합 표에 대한 결과는 아닙니다.

추가 검증과 실행 예제

  • tests/test_extended.py: CSS 선택자·우선순위·상속, 상대 글자 크기, RGBA 합성, 인라인 마커·북마크, 이미지 보존, DOCTYPE 및 중첩 p 처리.
  • tests/test_examples.py: 예제 30개를 별도 프로세스로 실행하고 DOCX를 다시 열어 실제 표·수식·링크·마커·템플릿 결과를 검증.
  • 실행 예제 30개: 전체 코드·입력 HTML·생성 DOCX·LibreOffice PDF.
  • LibreOffice 24.2.7.2에서 예제 30개의 수식 224개 가져오기와 PDF 출력을 검사했습니다. 앞선 검사에서는 확보한 원본 이슈 입력도 렌더링했습니다. 보고서·목록·수식 등 주요 화면을 별도로 확인했습니다.
  • Qt HTML의 글꼴 크기만으로 제목 의미를 자동 추정하지는 않습니다. CSS 서식 보존과 명시적인 제목으로 처리하며, Markdown은 선택 프런트엔드로 지원합니다.

추가 CSS 지원 후 같은 300행×3열 입력의 재측정값은 0.089초였습니다(1회 측정).