# HTML을 Typst로

의미 구조를 갖춘 HTML을 편집하고, 컴파일하고, 프로젝트로 만들 수 있는 단독 Typst 문서로 변환합니다.

HTML을 Typst로는 구조화된 웹 마크업을 받아 Typst 소스로 바꿔 줍니다. 제목, 문단, 강조, 목록, 링크, 간단한 표가 넘어오므로 직접 다시 만들 필요가 없습니다.

## 이럴 때 사용하세요

- 내가 HTML을 썼거나 그 내용을 재사용할 권한이 있을 때
- 페이지가 제목, 문단, 목록 같은 의미 있는 요소를 사용할 때
- 페이지를 시각적으로 베낀 것이 아니라 Typst의 문서 구조를 원할 때

HTML 자체를 붙여 넣으세요. 이 도구는 웹페이지를 내려받거나, 스크립트를 실행하거나, CSS와 JavaScript에 의존하는 레이아웃을 재현하지 않습니다.

## 마크업 변환하기

1. **HTML을 Typst로**를 열거나 `/html-to-typst`를 실행합니다.
2. HTML 조각이나 전체 문서를 붙여 넣거나 **예시 불러오기**를 선택합니다.
3. **변환**을 선택합니다.
4. 생성된 Typst를 읽습니다.
5. 복사하거나, `converted.typ`를 저장하거나, **프로젝트 만들기**를 선택해 Typst 프로젝트로 엽니다.

예를 들어:

```html
<h2>Method</h2>
<p>We compared <strong>three</strong> conditions.</p>
<ul><li>Control</li><li>Treatment</li></ul>
```

은 Typst의 제목, 굵은 텍스트가 있는 문단, 글머리 기호 목록이 됩니다.

## 옮겨지는 것

Oleafly와 함께 제공되는 Pandoc이 내 기기에서 의미 구조를 변환합니다. 격자 레이아웃, 반응형 중단점, 애니메이션, 대부분의 CSS 스타일은 Typst에 대응물이 없어 제외됩니다.

변환한 뒤에는 링크, 코드 블록, 표, 중첩 목록, 이미지 참조를 확인하세요. 이 도구는 원격 이미지나 스타일시트를 가져오지 않습니다. `.html` 파일을 이미지와 함께 가져오려면 라이브러리의 **프로젝트 가져오기 → HTML 페이지**를 사용하세요. Typst 프로젝트를 만들고 내장 이미지를 `assets/`로 추출할 수 있습니다. [가져오기 가이드](/docs/import-project/)에서 다룹니다.

LaTeX가 목적지라면 [HTML을 LaTeX로](/docs/tools/html-to-latex/)를 사용하세요.
