Markdown Linter
Markdown의 스타일과 형식 오류를 실시간으로 검사. 규칙 ID·줄 번호가 포함된 결과를 클릭하면 해당 줄로 이동. 브라우저에서 처리하며 Markdown은 서버로 보내지 않음.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
검사 내용
markdownlint 전체 규칙을 적용합니다. 주요 내용:
- MD001 — 제목 레벨은 한 번에 1단계씩만 증가
- MD004 — 목록 기호는 문서 안에서 한 가지로
- MD009 — 줄 끝에 공백을 두지 않음
- MD012 — 연속 빈 줄을 여러 개 두지 않음
- MD013 — 한 줄은 80자까지
- MD022 — 제목 앞뒤에 빈 줄 삽입
- MD026 — 제목 끝에 문장 부호를 붙이지 않음
- MD034 — 링크 문법 없이 쓴 URL(bare URL) 대신 링크 문법 사용
- MD041 — 첫 줄은 최상위 제목이어야 함
한국어 문서에서 자주 나오는 지적
한국어는 띄어쓰기를 하므로 중국어·일본어 문서와 달리 긴 문단이 MD013에 걸립니다. 한 문단을 한 줄로 쓴 README를 붙여 넣으면 다음과 같이 나옵니다.
# 안내
이 문장은 한국어로 작성한 긴 설명이며 띄어쓰기가 있어서 줄 길이 규칙이 적용됩니다. 이 문장은 한국어로 작성한 긴 설명이며 띄어쓰기가 있어서 줄 길이 규칙이 적용됩니다.
줄 3 [MD013] Line length — Expected: 80; Actual: 95
3번째 줄은 95자입니다. MD013은 글자 수를 세며, 한글 음절이 영문자보다 넓게 보여도 한 글자로 계산합니다. 80번째 글자 뒤에 공백이 하나도 없는 줄만 예외로 둡니다(MD013 문서). 문장 단위로 줄을 바꾸거나, 자신의 .markdownlint.json에서 line_length를 늘려 해결합니다.
제목의 문장 부호와 굵게
다음 문서에서는 한 가지만 지적되고, 화면에서 깨지는 부분은 지적되지 않습니다.
# 설치 안내
## 설치 방법:
**"중요"**합니다. **굵게**는 됩니다.
줄 3 [MD026] Trailing punctuation in heading — Punctuation: ':'
- MD026의 기본 대상은
.,;:!。,;:!이며, 물음표는 FAQ 형식의 제목에서 자주 쓰여 기본값에서 빠져 있습니다(MD026 문서). ‘## 설치 방법:’의 콜론은 지적되고, ‘## 설치가 안 되나요?’는 지적되지 않습니다. - 5번째 줄의
**"중요"**합니다는 굵게 표시되지 않습니다. 닫는**앞이 따옴표이고 뒤에 바로 한글 ‘합니다’가 붙어 있어서, CommonMark 0.31.2의 6.2절 규칙으로는 강조를 닫을 수 없습니다. 같은 줄의**굵게**는은 앞에 문장 부호가 없으므로 굵게 표시됩니다. markdownlint는 이 차이를 검사하지 않습니다.
굵게가 풀리는 경우와 해결 방법은 마크다운 문법 정리에, 실제 표시 결과는 Markdown 미리보기에서 확인할 수 있습니다.
예시: CHANGELOG
입력:
# Changelog
## 1.2.0
### Added
- Export button
## 1.1.0
### Added
* Dark mode
See https://example.com/releases
‘결과 복사’ 결과(markdownlint 0.40, 기본 규칙, 입력이 줄바꿈으로 끝남. 마지막 줄바꿈이 없으면 MD047도 나옵니다). 결과는 규칙 번호 순, 같은 규칙 안에서는 줄 번호 순입니다.
줄 13 [MD004] Unordered list style — Expected: dash; Actual: asterisk
줄 11 [MD024] Multiple headings with the same content [Added]
줄 15 [MD034] Bare URL used [https://example.com/releases]
- 두 버전 모두 ‘Added’ 제목이 있어 MD024가 나옵니다. Keep a Changelog의 표준 구성이므로, 자신의 설정에서
"MD024": { "siblings_only": true }로 부모가 다른 같은 이름의 제목을 허용합니다. - MD004는 문서 전체에서 목록 기호를 한 가지로 맞추라고 요구합니다. 첫 목록이
-이므로*가 지적됩니다. - MD034는 링크 문법 없이 쓴 URL(bare URL)을
<https://example.com/releases>나 Markdown 링크로 쓰라고 요구합니다.
여기서 바꿀 수 없는 기본값
도구는 markdownlint가 기본으로 켜는 규칙 전체를 기본 설정으로 실행합니다(markdownlint rules 참고). 설정 화면이 없어서 다음 두 규칙이 자주 불필요한 지적을 만듭니다:
- MD013 줄 길이는 80자입니다. 위에서 본 것처럼 띄어쓰기가 있는 한국어 문단도 대상입니다.
- MD024는 문서 안에서 같은 제목 텍스트가 반복되면 지적합니다. 위의 CHANGELOG가 그 예입니다.
자신의 설정으로 검사하려면 .markdownlint.json에 적고 로컬이나 CI에서 markdownlint-cli2를 실행합니다:
{
"MD013": { "line_length": 120 },
"MD024": { "siblings_only": true }
}
markdownlint는 파일 앞의 YAML Front Matter를 건너뛰며, 그 안의 title은 MD041에서 최상위 제목으로 취급합니다.
제한 사항
- 규칙 설명과 세부 정보는 markdownlint가 제공하며, 모든 언어 버전에서 영어입니다.
- 문제를 보고만 하고 자동으로 고치지는 않습니다. markdownlint-cli2의
--fix로 상당수를 자동 수정할 수 있습니다. - 한 번에 문서 하나를 기본 설정으로 검사하며
.markdownlint.json을 올릴 수 없습니다. 문서 안의<!-- markdownlint-disable MD013 -->,<!-- markdownlint-enable MD013 -->,<!-- markdownlint-disable-next-line MD034 -->주석으로 일부 구간만 규칙을 끌 수 있습니다. - 맞춤법, 문서 밖 링크의 유효성, GitHub 같은 렌더러에서의 실제 표시는 확인하지 않습니다.
개인정보
markdownlint는 이 페이지 안에서 실행됩니다. Markdown은 업로드되지 않고 브라우저 저장소에도 저장되지 않습니다. 페이지를 새로 고치면 에디터는 예시 문서로 돌아갑니다. 통계에는 ‘결과 복사’로 복사에 성공했다는 사실만 기록되며, 복사에 실패하면 기록하지 않습니다.
관련 도구
- Markdown 미리보기 — Markdown을 HTML로 실시간 렌더링
- Markdown 표 생성기 — 시각적으로 표 작성
FAQ
내 콘텐츠가 서버로 전송됩니까?
아니요. markdownlint가 이 페이지에 포함되어 있어 브라우저 안에서 Markdown을 검사합니다. 내용은 서버로 보내지 않으며, 도구가 브라우저 저장소에 저장하지도 않습니다. 페이지는 Google Analytics를 불러오며, ‘결과 복사’로 복사에 성공하면 도구 이름과 ‘copy_results’ 동작을 기록합니다. Markdown과 검사 결과는 포함하지 않으며, 복사에 실패하거나 복사할 문제가 없으면 기록하지 않습니다.
어떤 규칙을 검사합니까?
markdownlint 0.40의 규칙 53개 전체를 기본 설정으로 실행합니다. 제목 레벨, 줄 끝 공백, 빈 줄 개수, 링크 문법 없이 쓴 URL(bare URL), 목록 기호, 코드 펜스 등을 검사합니다. MD043(필수 제목 구조)이나 MD044(고유 명사 표기)처럼 설정해야 동작하는 규칙은 이 페이지에 설정 항목이 없으므로 아무것도 보고하지 않습니다.
MD001 같은 규칙 ID는 무엇을 의미합니까?
규칙 ID는 markdownlint의 규칙 번호입니다. MD001의 별칭은 heading-increment(제목 레벨은 한 단계씩), MD009는 no-trailing-spaces(줄 끝 공백), MD041은 first-line-heading(첫 줄은 최상위 제목)입니다. 규칙별 설명은 markdownlint 저장소의 규칙 문서에 있습니다.
결과를 클릭하면 해당 줄로 이동할 수 있습니까?
네. Lint 결과를 클릭하면 에디터가 해당 줄로 스크롤되고 해당 줄이 선택됩니다.
CLI markdownlint 도구와 어떻게 다릅니까?
CLI 도구는 빌드 파이프라인에 통합해 디스크 파일을 검사하고 설정 파일도 읽습니다. 이 브라우저 도구는 설치 없이 Markdown을 빠르게 확인하고 싶을 때 유용합니다.
한국어 문장도 MD013 줄 길이에 걸립니까?
네. 한국어는 띄어쓰기를 하므로 80번째 글자 뒤에 공백이 있으면 MD013이 보고합니다. 띄어쓰기가 없는 중국어나 일본어의 긴 줄이 대개 통과하는 것과 다릅니다. 한글 음절은 화면에서 영문자보다 넓게 보여도 한 글자로 셉니다.