본문 바로가기

Markdown 문법 검사기

브라우저 처리

Markdown 문서에서 120자 넘는 줄, # 뒤 공백 없는 제목, 줄 끝 공백, 단계를 건너뛴 제목, 닫히지 않은 코드 블록을 줄 번호와 함께 찾아 줍니다.

사용 전 확인
  • 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
도구 실행입력 후 결과 확인
Markdown 문법 검사기 샘플 실행

Markdown은 문법이 느슨해서 틀려도 그냥 보이지만, 문서 사이트나 GitHub에서는 모양이 깨지거나 목차가 엉망이 되기도 합니다. 이 검사기는 문서를 넣으면 흔한 문제를 찾아 몇 번째 줄인지와 함께 알려 줍니다.

브라우저 처리
샘플 결과
2행: 제목 단계를 건너뛰었습니다
닫히지 않은 코드 블록이 있습니다
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

Markdown 문법 검사기 사용 가이드

Markdown은 문법이 느슨해서 틀려도 그냥 보이지만, 문서 사이트나 GitHub에서는 모양이 깨지거나 목차가 엉망이 되기도 합니다. 이 검사기는 문서를 넣으면 흔한 문제를 찾아 몇 번째 줄인지와 함께 알려 줍니다.

검사 항목은 120자가 넘는 긴 줄, # 뒤 공백이 없는 제목(#제목), 줄 끝 공백(줄바꿈용 두 칸은 제외), 단계를 건너뛴 제목(H1 다음 바로 H3), 닫히지 않은 코드 블록(```)입니다. 문제가 없으면 '통과'를 표시합니다.

링크 문법 오류나 맞춤법은 검사하지 않습니다. 링크는 Markdown 링크 추출기나 로컬 링크·이미지 검사기로 따로 확인하세요.

사용 방법

  1. '.md·.txt 파일'에서 검사할 문서를 고르거나 'Markdown 내용'에 README 같은 문서를 붙여 넣습니다.
  2. '실행'을 누르면 '2행: 제목 단계를 건너뛰었습니다'처럼 줄 번호와 문제가 나옵니다.
  3. 해당 줄을 고치고 다시 실행해 '통과'가 나오는지 확인합니다.

예시: 제목 건너뜀과 열린 코드 블록

입력
# Title
### Skipped heading
[broken](
```js
code
결과
2행: 제목 단계를 건너뛰었습니다
닫히지 않은 코드 블록이 있습니다

H1 다음에 바로 H3이 와서 경고가 나옵니다. 3행의 깨진 링크 문법은 검사 대상이 아니라 나오지 않습니다.

이럴 때 쓰면 좋아요

  • README를 커밋하기 전 기본 문법을 점검할 때
  • 문서 사이트에서 목차가 이상하게 나올 때 원인을 찾을 때
  • 코드 블록이 열린 채 끝나 아래 내용이 모두 코드로 보일 때
  • 팀 문서의 줄 길이 기준을 맞출 때

문제가 생겼을 때

줄 끝 공백 경고가 많이 나옴

편집기에서 '저장 시 줄 끝 공백 제거'를 켜거나 Markdown 포맷터로 한 번에 지우세요. 줄바꿈용 두 칸 공백은 경고하지 않습니다.

긴 줄 경고가 표 줄에서 나옴

표나 긴 URL이 있는 줄은 120자를 넘기 쉽습니다. 이런 줄은 경고를 참고만 하세요.

활용 팁

  • 제목 단계는 H1 → H2 → H3 순서로 하나씩 내려가야 목차와 화면 낭독기가 문서 구조를 제대로 읽습니다.
  • 검사 전에 Markdown 포맷터로 기본 표기를 정리하면 남은 경고에 집중하기 쉽습니다.

자주 묻는 질문

markdownlint와 같은 규칙인가요?

많이 쓰는 몇 가지 규칙만 간단히 검사합니다. 전체 규칙이 필요하면 markdownlint 같은 전용 도구를 함께 쓰세요.

줄 번호는 어떻게 세나요?

문서 첫 줄을 1행으로 셉니다. 편집기의 줄 번호와 같습니다.

문서가 자동으로 고쳐지나요?

아니요. 문제만 알려 줍니다. 표기 정리는 Markdown 포맷터를 쓰세요.