# LaTeX를 HTML로

웹에서 읽고, 공유하고, 접근성을 점검할 수 있도록 MathML 수식이 들어간 독립형 HTML을 만듭니다.

LaTeX를 HTML로 도구는 원고가 PDF 밖에서도 쓰이게 해 줍니다. 문서 구조를 브라우저에서 읽을 수 있는 HTML로 바꾸고 수식은 MathML로 쓰므로, 결과물에서 텍스트를 선택할 수 있고 화면 크기에 맞게 다시 배치되며 페이지 이미지보다 보조 기술이 해석하기 쉽습니다.

## 이럴 때 쓰세요

- 논문, 보고서, 노트 모음의 웹 사본이 필요할 때
- 휴대폰과 좁은 화면에서 내용이 다시 배치되어야 할 때
- 독자가 텍스트를 선택하고 수식을 살펴볼 수 있어야 하는 검토용 사본이 필요할 때
- PDF를 대신할 접근성 중심의 HTML 대체본이 필요할 때

학술지 PDF의 디자인을 그대로 재현하지는 않습니다. 정확한 쪽 나눔과 인쇄 레이아웃이 목표라면 PDF로 내보내세요.

## 소스 변환하기

1. **LaTeX를 HTML로**를 열거나 `/latex-to-html` 명령을 실행하세요.
2. 변환할 LaTeX 소스를 붙여 넣으세요.
3. **변환**을 선택하세요.
4. `converted.html` 파일을 저장하고 브라우저에서 여세요.
5. 제목, 링크, 수식, 그림, 표, 참고문헌을 확인하세요.

다음과 같은 절은

```latex
\section{Result}
For $x > 0$, the loss decreases monotonically.
```

HTML 제목과 단락이 되고, 인라인 수식은 MathML로 표현됩니다.

## 결과에 들어 있는 것

내장 Pandoc 경로는 독립형 HTML 문서를 만들고, 찾을 수 있는 리소스를 문서에 포함하며, 수식에는 MathML을 씁니다. 변환은 이 컴퓨터에서 실행됩니다.

사용자 정의 LaTeX 매크로, 출판사 클래스, 원시 TeX, 페이지에 직접 그리는 패키지는 HTML에 대응하는 것이 없을 수 있습니다. 참고문헌 표시도 변환기에 전달된 소스와 인용 설정에 따라 달라집니다.

:::caution[접근성을 갖춘 HTML도 검토가 필요합니다]
MathML과 의미를 갖춘 제목은 더 나은 출발점이 되지만, 페이지가 접근성 표준을 충족한다는 인증은 아닙니다. 키보드 이동 순서, 링크 텍스트, 이미지 대체 텍스트, 표 머리글, 색 대비를 점검하고, 독자가 쓰는 보조 기술로 결과를 직접 확인하세요.
:::

태그가 지정된 PDF 작업 흐름에는 [프리플라이트](/docs/preflight/)를 쓰고, 결과를 접근성을 갖춘 문서로 공유하기 전에 PDF/UA 관련 한계를 읽어 보세요. Typst 소스에는 [Typst를 HTML로](/docs/tools/typst-to-html/)를 쓰세요.
