Qiita / Zenn 호환성 검사기
Qiita와 Zenn은 일본의 개발자 글쓰기 플랫폼으로, 두 곳의 Markdown 방언이 서로 다릅니다. 글을 붙여 넣으면 공개한 뒤에야 드러나는 깨짐을 미리 찾아 줍니다. 1 대 1로 대응되는 부분은 변환하지만 결과물은 초안입니다.
글의 Markdown을 붙여 넣으세요. frontmatter까지 함께 넣으면 제목과 태그도 검사합니다.
할 수 있는 일과 없는 일
- 검출할 수 있는 것은 정리해 둔 차이 74건입니다. 자동 변환 37건, 사람의 판단이 필요한 것 14건, 대응하는 표기가 없는 것 23건입니다.
- Zenn은 raw HTML을 그리지 않습니다. Qiita 글에서 자주 쓰는 details 접기, img의 폭 지정, dl 정의 목록은 Zenn에서 오류가 나지 않고 태그 문자열이 본문에 그대로 보입니다.
- 오류도 경고도 없이 깨지는 차이가 21건 있습니다. 이 종류는 공개 후 화면에서만 드러나므로 미리보기 확인을 전제로 하세요.
- Qiita 쪽 렌더러는 실행하지 않았습니다. Qiita에서 최종적으로 어떻게 보이는지에 대한 판단은 공식 문서와 구현 코드 읽기에 근거합니다.
- 다루는 것은 본문과 frontmatter 텍스트뿐입니다. 이미지 파일을 옮기거나 업로드하지 않으며, 붙여 넣은 내용은 브라우저 밖으로 나가지 않습니다.
Qiita와 Zenn의 표기 차이에 대하여
이 도구가 하는 일은 진단입니다
Qiita와 Zenn은 일본 개발자들이 글을 올리는 대표적인 두 플랫폼으로, 둘 다 각자의 확장을 얹은 Markdown을 받습니다. 두 곳 사이에는 정리된 차이가 74건 있습니다. 그중 1 대 1 대응이 있어 기계적으로 변환할 수 있는 것은 37건입니다. 나머지는 어느 쪽으로 맞출지 사람이 정해야 하는 14건과, 옮길 곳에 대응하는 표기가 아예 없는 23건입니다. 자동 변환은 이 37건에만 적용하고, 나머지는 지적과 선택지 제시에 그칩니다.
Zenn은 HTML을 그리지 않습니다
Zenn의 렌더러는 markdown-it을 기본 설정으로 사용하며 raw HTML을 통과시키지 않습니다. 그래서 Qiita 글에서 흔한 details 접기, 폭을 지정한 img, dl 정의 목록은 Zenn에서 오류가 나지 않고 태그 문자열이 독자에게 그대로 보입니다. 빌드는 통과하고 경고도 없으므로 공개한 뒤에야 알게 됩니다. 이런 종류의 차이가 21건 있습니다.
note와 message는 1 대 1이 아닙니다
Qiita의 note 블록은 info / warn / alert의 세 단계이지만, Zenn의 message는 기본과 alert의 두 단계뿐입니다. warn을 그대로 :::message warn이라고 쓰면 블록이 되지 않고 그 문자열이 본문에 표시됩니다. 이 도구는 warn을 기본과 alert 중 어느 쪽으로 맞출지 고르게 하고, 임의로 정하지 않습니다.
Zenn → Qiita 방향이 구조적으로 안전합니다
Qiita는 raw HTML을 통과시키므로 Zenn 고유 표기를 HTML로 바꿔 옮길 수 있습니다. 떨어져 나가는 것은 대표 이모지나 공개 일시처럼 Zenn 쪽에만 있는 frontmatter이며 Qiita에서는 쓰지 않는 항목입니다. 반대 방향보다 사고는 적지만, Qiita에서의 표시는 이 도구로 실측하지 않았으므로 확인은 똑같이 필요합니다.
공개 전에 반드시 표시를 확인하세요
Zenn의 slug는 사이트 전체에서 고유하며 한 번 만들면 바꿀 수 없습니다. 공개 일시도 마찬가지로 나중에 바꿀 수 없습니다. 잘못된 내용으로 공개하면 되돌릴 수 없으므로, 결과물은 초안으로 다루고 미리보기로 본 다음 공개하세요.