마크다운 유효성 검사기
Markdown 구문을 검증하고 닫히지 않은 펜스, 깨진 링크, 잘못된 표 등 일반적인 문제를 감지 — 브라우저에서 완전히 실행됩니다.
마크다운 입력
유효성 검사 보고서
마크다운 유효성 검사 예시
유효한 마크다운은 올바른 간격과 닫힌 펜스를 가집니다. 예시:
유효한 마크다운
유효하지 않음 – 제목 뒤 공백 누락 및 닫히지 않은 코드 펜스
#API는 # 뒤에 공백이 필요합니다. 코드 블록에 닫는 ```가 없습니다.
위 편집기에 예시 중 하나를 붙여넣으세요. 샘플을 사용하여 더 많은 데이터를 불러오세요.
마크다운 유효성 검사기란?
마크다운에는 구문 규칙이 있습니다. 닫히지 않은 코드 펜스, 깨진 링크, 잘못된 표 또는 유효하지 않은 HTML은 렌더링 문제를 일으킬 수 있습니다. 마크다운 유효성 검사기는 문서를 확인하고 일반적인 문제를 보고합니다. CommonMark 명세가 구문을 정의합니다.
이 도구는 마크다운을 파싱하고 유효성 검사 보고서를 생성합니다. 완전히 브라우저에서 실행됩니다. 서버로 아무것도 전송되지 않습니다. 형식 지정에는 마크다운 포매터를 사용하세요. 린팅(스타일 규칙)에는 마크다운 린터를 사용하세요.
이 도구 사용 방법
마크다운 붙여넣기 또는 업로드
마크다운을 복사하여 왼쪽 편집기에 붙여넣으세요. 업로드를 클릭하여 .md 또는 .markdown 파일을 불러올 수도 있습니다. 샘플 버튼은 예시 데이터를 불러옵니다.
유효성 검사 보고서 확인
오른쪽 패널에 보고서가 표시됩니다. 닫히지 않은 펜스, 깨진 참조 링크, 잘못된 표 또는 빈 제목과 같은 문제를 나열합니다. 공유를 위해 보고서를 다운로드하세요.
수정 및 재검증
입력에서 문제를 수정하고 재검증하세요. 형식 지정에는 마크다운 포매터를 사용하세요. HTML로 변환하려면 마크다운 HTML 변환을 사용하세요.
마크다운 유효성 검사가 도움이 되는 경우
GitHub, GitLab 또는 Jekyll과 Hugo 같은 정적 사이트에 문서, README 또는 콘텐츠를 게시할 때, 유효성 검사는 렌더링이 깨지기 전에 문제를 찾아냅니다. GFM 명세가 표와 확장을 정의합니다. 닫히지 않은 코드 블록이나 잘못된 표는 전체 페이지를 망칠 수 있습니다. 여기서 마크다운을 실행하면 병합 또는 배포 전에 자신감을 얻을 수 있습니다.
여러 작성자의 콘텐츠나 AI 생성 마크다운에는 종종 미묘한 오류가 있습니다. 여기서 유효성 검사를 하면 체크리스트가 제공됩니다. 스타일 일관성(예: 제목 수준, 목록 형식)에는 마크다운 린터를 사용하세요.
자주 묻는 질문
마크다운 유효성 검사는 무엇을 확인하나요?
제목 레벨 건너뛰기(예: H1에서 H3으로 이동), 닫히지 않은 코드 블록, 잘못된 링크 구문, 일관되지 않은 목록 들여쓰기, 빈 제목 마커 등 일반적인 문제를 확인합니다. 이것들이 렌더링 오류의 가장 흔한 원인입니다.
유효한 마크다운이 모든 곳에서 올바르게 렌더링된다는 의미인가요?
반드시 그렇지는 않습니다. 다양한 마크다운 렌더러가 구문을 다르게 처리합니다. 유효성 검사는 CommonMark 사양을 기반으로 합니다. GitHub, GitLab 및 다른 도구들은 고유한 확장 기능을 추가합니다. 게시될 환경에서 문서를 테스트하세요.
README 파일을 유효성 검사할 수 있나요?
예 — README.md의 전체 내용을 편집기에 붙여넣고 유효성 검사를 클릭하세요. GitHub 또는 GitLab에 푸시하기 전에 서식 오류를 찾는 좋은 방법입니다.
유효성 검사에 크기 제한이 있나요?
없습니다. 유효성 검사는 브라우저에서 완전히 실행되므로 서버 측 제한이 없습니다. 매우 큰 문서는 처리하는 데 조금 더 걸릴 수 있지만 대부분의 README 및 문서 파일은 즉시 처리됩니다.
관련 도구
자세히 알아보기: CommonMark, CommonMark 명세, GitHub Flavored Markdown, Markdown Guide, GitHub, W3C HTML, GitLab, Hugo.