Markdown Linter

Markdown의 스타일과 형식 오류를 실시간으로 검사. 규칙 ID·줄 번호가 포함된 결과를 클릭하면 해당 줄로 이동. 브라우저에서 처리하며 Markdown은 서버로 보내지 않음.

  • 브라우저에서 처리
  • 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
  • 무료 · 회원가입 불필요
「지우기」 또는 도구 안에 포커스가 있을 때 Ctrl/⌘+L로 입력, 결과, 요약을 지웁니다. 대기 중인 검사를 취소하며 이전 결과나 복사 상태가 다시 나타나지 않습니다.
「결과 복사」는 표시된 문제마다 줄 번호, 대괄호 안의 규칙 ID, 설명, 세부 정보, 문맥을 한 줄의 텍스트로 복사합니다. 규칙 별칭은 제외합니다. 문제가 없으면 아무것도 복사하지 않습니다.
Markdown 문서 한 개를 편집합니다. 입력 후 300밀리초가 지나면 markdownlint 기본 규칙으로 검사하며, 처음 예시에는 의도적인 문제가 있습니다. 문서 안의 markdownlint-disable 및 markdownlint-enable 주석으로 규칙을 끌 수 있습니다. 설정 파일 업로드나 자동 수정 기능은 없습니다.
Lint 결과 각 문제에 규칙 ID, 줄 번호, 설명과 있는 경우 세부 정보, 문맥, 별칭을 표시합니다. 문제를 클릭하면 에디터에서 해당 줄을 선택합니다. 설명과 세부 정보는 markdownlint가 제공하는 영어이며, 검사는 문서를 바꾸지 않고 문제만 보고합니다.
입력하면 결과가 여기에 표시됩니다.
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.

검사 내용

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은 업로드되지 않고 브라우저 저장소에도 저장되지 않습니다. 페이지를 새로 고치면 에디터는 예시 문서로 돌아갑니다. 통계에는 ‘결과 복사’로 복사에 성공했다는 사실만 기록되며, 복사에 실패하면 기록하지 않습니다.

관련 도구

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이 보고합니다. 띄어쓰기가 없는 중국어나 일본어의 긴 줄이 대개 통과하는 것과 다릅니다. 한글 음절은 화면에서 영문자보다 넓게 보여도 한 글자로 셉니다.