MDN Web Docs 한국어 문서는 커뮤니티가 영어에서 옮긴 번역본입니다. 번역되지 않은 문서는 /ko/ 주소로 열면 'Page not found'가 나오고, 주소의 ko를 en-US로 바꾸면 영어 원문이 열립니다.
MDN Web Docs 한국어 문서 — 커뮤니티 번역본
MDN Web Docs는 모질라가 소유하고 전 세계 자원봉사자와 함께 만드는 오픈소스 문서입니다. 한국어 화면(developer.mozilla.org/ko)이 있지만 한국어 문서는 영어 원문을 커뮤니티가 옮긴 번역본입니다.
| 구분 | 내용 |
|---|---|
| 시작 | 2005년 DevMo → 2010년 Mozilla Developer Network |
| 운영 방식 | 2020년부터 GitHub 기반 |
| 번역 방식 | 한국어는 커뮤니티 번역 로캘 |
| 커뮤니티 번역 | 8개 로캘(한국어·일본어·프랑스어 등) |
| 기계 번역 | 독일어·이탈리아어(실험) |
| 화면 언어 | 10개 언어 선택, 'Remember language'로 고정 |
번역 문서 맨 위에는 'This page was translated from English by the community'라는 안내가 붙습니다. 문서 맨 아래에는 마지막 수정일이 적혀 있습니다. 예를 들어 한국어 JavaScript 문서는 2026년 7월 15일에 마지막으로 고쳐졌습니다.
번역본의 오류는 문서 아래 'Report a problem with this content'로 알리거나 'View this page on GitHub'에서 직접 고칠 수 있습니다. 한국어 번역은 GitHub의 mdn/translated-content 저장소에서 관리하고, 한국어 담당 메인테이너가 따로 있습니다.
MDN Web Docs 한국어 문서가 없을 때 영어 원문 보는 법
MDN Web Docs에서 한국어로 검색해 들어갔는데 'Page not found'가 뜨는 경우가 있습니다. 한국어로 번역되지 않은 문서이기 때문입니다.
- 번역 없는 문서 — /ko/ 주소에서 404 Page not found
- 예시 — Navigation API — /ko/ 404, /en-US/ 정상
- 해결 — 주소의 ko를 en-US로 바꿈
- 번역 있는 문서 — 위쪽 'View in English' 버튼
- 항상 영어로 — 'Always switch to English' 버튼
- 언어 메뉴 — 화면 위 언어 선택
영어 원문으로 바꾸는 순서입니다.
- 주소창에서 developer.mozilla.org/ko/docs/… 부분을 찾습니다.
- ko를 en-US로 바꾸고 엽니다.
- 번역 문서라면 위쪽 'View in English'를 누르면 같은 문서의 영어판으로 갑니다.
- 앞으로 계속 영어로 보려면 'Always switch to English'를 누릅니다.
한국어 첫 화면에 소개된 Navigation API, Trusted Types API, CSS 앵커 포지셔닝 문서는 2026년 10월 현재 모두 한국어판이 없어 /ko/ 주소에서 404가 납니다.
MDN Web Docs Baseline 표시 읽는 법
MDN Web Docs 문서 위나 아래에 붙는 Baseline 표시는 그 기능을 주요 브라우저가 얼마나 지원하는지 요약한 것입니다.
- Widely available — 기준 브라우저 전부에서 2.5년 이상 꾸준히 지원
- Newly available — 기준 브라우저의 최신 안정판에서만 확인
- Limited availability — 아직 모든 브라우저에서 되지 않음
- Deprecated — 일부에서 되더라도 개발에 쓰지 말 것
- Deprecated to be removed — 곧 제거될 예정
- 기준 브라우저 — 주요 브라우저의 데스크톱·모바일 7종
Baseline은 요약일 뿐 테스트를 대신하지 않는다고 MDN Web Docs는 분명히 적고 있습니다. 다음은 Baseline이 알려 주지 않습니다.
- 오래된 기기와 구버전 브라우저
- OS 웹뷰처럼 Baseline 정의에 들어가지 않는 브라우저
- 스크린리더 같은 보조 기술
Newly available 기능은 오래된 브라우저와 기기에서 안 될 수 있습니다. 세부 버전은 문서 아래 브라우저 호환성 표에서 봅니다. 이 표는 GitHub의 browser-compat-data 저장소 데이터로 만들어집니다.
MDN Web Docs 문서·코드 예제 라이선스
MDN Web Docs의 글과 코드를 옮겨 쓸 때는 본문과 코드 예제의 라이선스가 다릅니다.
- 문서 본문 — CC-BY-SA 2.5 이상, 같은 라이선스로 재공개
- 출처 표기 — 문서 제목 + 링크 + 'Mozilla Contributors' + 라이선스
- 코드 예제(2010-08-20 이후) — 퍼블릭 도메인(CC0), 표기 불필요
- 코드 예제(그 이전) — MIT 라이선스
- 구분 방법 — 2020-12-14 새 플랫폼 이후 확인 방법 없음
- 로고·상표·디자인 — CC 라이선스 대상 아님
본문을 옮기면 옮긴 글도 CC-BY-SA로 공개해야 하고, 고친 부분이 있으면 짧게 밝혀야 합니다. 공식 예시는 문서 제목에 링크를 걸고 'by Mozilla Contributors, licensed under CC-BY-SA 2.5'라고 적는 방식입니다.
코드 예제는 언제 추가됐는지에 따라 CC0와 MIT로 갈리지만, 2020년 12월 14일 새 플랫폼으로 옮긴 뒤로는 어느 쪽인지 확인할 방법이 없다고 공식 문서에 적혀 있습니다.
MDN 문서로 링크를 거는 것은 따로 허락받지 않아도 됩니다. 반대로 다른 곳에 실린 글을 MDN에 옮겨 싣는 것은 원칙적으로 받지 않습니다.
MDN Web Docs Plus 요금과 제공 국가
MDN Web Docs 문서 자체는 무료입니다. MDN Plus는 2022년 3월에 나온 개인화 구독 서비스이고, 공식 FAQ에 적힌 요금은 다음과 같습니다.
- MDN Core — 무료, 프리미엄 기능 일부
- MDN Plus 5 — 월 5달러 · 연 50달러
- MDN Supporter 10 — 월 10달러 · 연 100달러
- 연 결제 — 20% 할인
- 플랜 낮추기 — 해지 후 새로 가입(올리기만 바로 가능)
- 유료 제공 국가 — FAQ 목록에 한국 없음
무료 MDN Core는 전 세계에서 쓸 수 있지만, 유료 플랜은 FAQ에 적힌 국가에서만 판매합니다. 이 목록은 미국·캐나다와 유럽 여러 나라, 말레이시아·뉴질랜드·싱가포르 등이고 한국은 들어 있지 않습니다.
MDN Plus에 들어가는 기능은 업데이트 알림, 컬렉션(문서 모음), 오프라인 보기 등입니다. 문서 본문은 Plus 가입 여부와 상관없이 그대로 무료로 공개되고, CC-BY-SA로 계속 재사용할 수 있다고 FAQ에 적혀 있습니다.
화면에서 바로 코드를 실행해 보는 Playground와 웹 개발 학습 과정(Learn, Curriculum)도 MDN Web Docs 안에 있습니다.
MDN Web Docs HTTP Observatory 보안 검사
MDN Web Docs의 HTTP Observatory는 사이트의 HTTP 보안 헤더와 설정을 검사해 등급을 매기는 무료 도구입니다. 도메인이나 주소를 넣고 Scan을 누르면 됩니다.
- 출시 — 2016년, 2024년 7월 2일 MDN으로 이전
- 검사 항목 — XSS·중간자 공격 대비, 쿠키, 인증서 등
- 검사 안 하는 것 — SQL 인젝션, 구버전 소프트웨어, CMS 플러그인 취약점
- 검사 기록 — 도메인별로 공개
- 재검사 간격 — 같은 사이트 60초
- 옛 Observatory — TLS·SSH 등 포함, 2024년 10월 종료
A+ 등급을 받아도 사이트가 안전하다는 뜻은 아니라고 공식 FAQ가 직접 말합니다. 비밀번호 저장 방식이나 플러그인 취약점처럼 Observatory가 검사하지 않는 항목도 똑같이 중요합니다.
누구나 아무 도메인이나 검사할 수 있고 도메인별 검사 기록은 공개됩니다. 예전처럼 결과를 비공개로 두는 옵션은 없어졌습니다. 보고서 링크를 열 때 이전 결과가 24시간보다 오래됐으면 다시 검사합니다.
API 주소도 검사할 수는 있지만 웹사이트용 도구라 결과가 API의 보안 상태를 정확히 보여 주지 않을 수 있다고 안내합니다.
자주 묻는 질문
MDN Web Docs 한국어 문서가 'Page not found'로 나오는 이유는?
그 문서가 아직 한국어로 번역되지 않았기 때문입니다. 주소의 ko를 en-US로 바꾸면 영어 원문이 열립니다.
MDN Web Docs 한국어 문서를 항상 영어로 볼 수 있나요?
번역 문서 위쪽의 'Always switch to English' 버튼을 누르면 영어로 전환됩니다. 한 번만 보려면 'View in English'를 누릅니다.
MDN Web Docs의 Baseline Widely available은 무슨 뜻인가요?
기준이 되는 주요 브라우저 전부에서 2.5년 이상 꾸준히 지원된 기능이라는 뜻입니다. 오래된 기기나 OS 웹뷰, 스크린리더 지원까지 보장하지는 않습니다.





