Markdown은 문서, 메모, 블로그에 많이 쓰는 가벼운 마크업 형식입니다. 제목은 #, 목록은 -, 코드는 백틱으로 표시하고, 정적 사이트 생성기에 쓰는 파일은 맨 앞의 front matter에 제목과 날짜 같은 정보를 적습니다. 파일을 통째로 변환하면 코드 속 변수 이름이나 링크의 중국어 경로까지 바뀌어 코드가 동작하지 않거나 링크가 끊깁니다. 이 페이지는 Markdown 구조를 먼저 읽고 사람이 읽는 부분만 바꿉니다.
바뀌는 부분
- 본문, 제목, 목록, 표, 인용문.
- 링크 글자와 이미지의 alt 글자.
- front matter의 값.
- 제목을 가리키는 문서 안 링크(제목과 함께 바뀝니다).
- 문서에 넣은 HTML 태그의 title, alt 같은 글자 속성.
그대로인 부분
- 펜스 코드 블록, 들여쓰기 코드 블록, 인라인 코드. 코드 블록 안의 주석은 선택해서 바꿀 수 있으며, 기본은 그대로입니다.
- 링크와 이미지의 주소. 중국어 경로도 마찬가지입니다.
- front matter의 키 이름과 HTML 태그 자체.
아래 예시에서도 링크 주소 docs/使用文档.md와 인라인 코드 속 软件包는 간체 그대로 남습니다.
글자 깨짐과 편집기 호환
Markdown 편집기와 정적 사이트 생성기는 대개 파일을 UTF-8로 읽습니다. GBK나 Big5로 저장된 오래된 문서는 자동으로 인식해 UTF-8로 바꿉니다. 줄바꿈 문자는 원본 그대로이고 BOM도 기본으로 원본을 따르므로, 원본이 UTF-8이었다면 Git으로 비교했을 때 바뀐 글자만 차이로 나타납니다.
변환 예시
| 원문 | 결과 |
|---|---|
| ## 安装说明 | ## 安裝說明 |
| 请先阅读[使用文档](docs/使用文档.md)。 | 請先閱讀[使用文檔](docs/使用文档.md)。 |
| 运行 `npm install 软件包` 安装依赖。 | 運行 `npm install 软件包` 安裝依賴。 |
|  |  |
| | 名称 | 说明 | | | 名稱 | 說明 | |
| - **注意**:后台程序会自动更新。 | - **注意**:後臺程序會自動更新。 |
OpenCC(s2t)로 실제 변환한 결과입니다.
사용 방법
- .md나 .markdown 파일을 페이지에 끌어다 놓거나 ‘파일 선택’을 누릅니다. 문서 여러 개를 한 번에 골라도 됩니다.
- ‘방향’과 ‘표준’을 고릅니다. 대만 독자를 위한 문서라면 ‘대만’을 고르고 ‘지역 어휘 변환’을 켜 둡니다.
- 필요하면 ‘형식별 고급 옵션’을 펼쳐 코드 블록 안의 주석도 바꿀지 정합니다.
- 미리보기를 확인하고 받습니다. 파일이 여러 개면 ‘모두 다운로드(ZIP)’를 쓰세요.
주의할 점
- ‘지역 어휘 변환’을 켜면 기술 용어도 그 지역 표현으로 바뀝니다. ‘대만’ 표준에서는 程序 → 程式, 文件 → 檔案처럼 바뀌는데, 文件 단어가 공문서나 서류를 뜻할 때도 똑같이 바뀌니 기술 문서는 한 번 끝까지 읽어 보세요.
- 일대다 대응 글자가 홀로 쓰이면 틀릴 수 있고, 파일에는 강조 표시가 없습니다. 자신 없는 문단은 ‘텍스트’ 탭에 붙여 넣어 ‘확인 필요’ 글자를 보세요.
- 링크 주소는 docs/使用文档.md처럼 그대로 남습니다. 서로 링크하는 문서 묶음이라면 받을 때 ‘원래 이름 유지’를 고르세요. 언어 코드가 붙은 파일 이름은 링크와 맞지 않습니다.
자주 묻는 질문
코드 블록 안의 중국어도 바뀌나요?
바뀌지 않습니다. 펜스 코드 블록, 들여쓰기 코드 블록, 인라인 코드는 그대로이므로 변수 이름과 문자열도 그대로입니다. 코드 블록 안의 주석도 기본으로는 그대로이며, 고급 옵션에서 ‘Markdown: 코드 블록 안의 주석도 변환’을 켜면 바뀝니다.
목차에 있는 문서 안 링크가 계속 작동하나요?
작동합니다. 제목을 가리키는 링크는 제목과 함께 바뀌므로, [安装](#安装) → [安裝](#安裝)처럼 바뀌어 변환된 제목과 맞습니다.
front matter는 어떻게 되나요?
키 이름은 그대로 두고 제목이나 요약 같은 값만 바꿉니다. 값이 경로나 URL이면 그대로 둡니다.
문서 안의 HTML 태그는 어떻게 처리하나요?
태그 자체는 그대로 두고, 그 안의 title, alt 같은 글자 속성만 바꿉니다.