Markdown 수정 도구
손상된 Markdown을 자동으로 수정하고 복원합니다
Markdown 수정 도구란?
제목 위에 빈 줄이 없거나, 닫히지 않은 코드 펜스, 중간에 1로 다시 돌아가는 번호 목록 — Markdown을 작성해 봤다면 한 번쯤 겪어봤을 문제들입니다. 이 도구가 문서를 살펴보고 구조적인 문제를 자동으로 수정해 드립니다. 손상된 Markdown을 왼쪽에 붙여넣으면 깔끔한 버전이 오른쪽에 나타납니다 — 내용은 그대로, 주변 구조만 정리됩니다.
도구는 CommonMark 명세를 기본으로 하고 GitHub Flavored Markdown 확장(테이블, 작업 목록, 취소선)을 함께 지원합니다. 적용하는 규칙은 markdownlint와 거의 동일합니다.
모든 처리는 브라우저 내에서 실행됩니다 — 텍스트는 컴퓨터에 남아 있습니다. 몇 초 만에 Markdown을 수정하고 작업을 계속하세요.
Markdown 수정 도구 사용법
세 단계입니다. 각 단계는 이 페이지의 실제 버튼을 사용합니다.
손상된 Markdown 붙여넣기 또는 샘플 불러오기
Markdown을 왼쪽 편집기에 붙여넣으세요. 샘플 Markdown을 클릭하면 흔한 손상 사례가 포함된 예시를 불러올 수 있습니다.
# Order Processing
```python
def process(order):
| Stage | Owner |
|-------|-------
[doc][missing-ref수정 도구는 빈 줄 간격을 조정하고, 닫히지 않은 코드 블록을 닫고, 목록 들여쓰기를 정리하며, 강조 기호의 균형을 맞춥니다.
"Markdown 수정하기!!" 클릭
도구 모음의 녹색 Markdown 수정하기!! 버튼을 클릭하세요. 도구가 문서를 분석하고 구조 문제를 자동으로 다시 작성합니다. 처리 중에는 로딩 표시기가 나타납니다.
수정된 출력 확인
오른쪽 패널에 정리된 Markdown이 표시됩니다. 본문, 제목, 코드 샘플은 그대로이고 간격, 펜스, 들여쓰기만 다시 작성됩니다.
이 도구를 활용하는 상황
README 정리
커밋 전에 프로젝트 README를 수정 도구에 통과시키세요. GitHub은 Markdown을 엄격하게 렌더링하므로 닫히지 않은 펜스 하나가 파일의 절반을 삼킬 수 있습니다.
붙여넣은 콘텐츠 정리
Notion, Confluence, 채팅에서 Markdown 파일로 복사하면 깨진 글머리 기호와 비표준 공백이 남습니다. 수정 도구가 이를 깔끔한 CommonMark로 정리합니다.
정적 사이트 생성기
Hugo, Jekyll, Astro, MkDocs — 모두 같은 종류의 구조적 오류에 막힙니다. 소스를 한 번 정리하면 빌드 파이프라인이 더 이상 불평하지 않습니다.
AI 생성 Markdown 정리
LLM은 종종 ``` 닫기를 잊거나 H2에서 H4로 건너뜁니다. 수정 도구가 제목 계층을 정규화하고 펜스의 균형을 맞춥니다.
자주 묻는 질문
Markdown 데이터가 저장되나요?
아니요. 수정 도구는 전적으로 브라우저 내에서 실행됩니다 — 서버 통신이 없습니다. 텍스트가 탭을 벗어나지 않습니다.
어떤 문제를 수정할 수 있나요?
제목과 목록 주변의 빈 줄, 닫히지 않은 코드 블록, 한 목록 안에서 섞인 글머리 기호, 끊긴 번호 목록, 균형이 맞지 않는 강조, 정의되지 않은 라벨을 가리키는 참조 링크, 파이프 수가 어긋난 표 행 등을 수정합니다.
내용이 바뀌나요?
아니요. 수정 도구는 구조적 공백, 펜스 마커, 목록 글머리 기호, 링크 구문만 건드립니다. 본문, 제목, 코드 블록의 내용은 그대로 보존됩니다.
CommonMark와 GFM 중 어느 것을 따르나요?
둘 다입니다. 기본 문법은 CommonMark를 따르고, GFM 확장(테이블, 작업 목록, 자동 링크, 취소선)도 그대로 유지됩니다.
큰 Markdown 파일에도 사용할 수 있나요?
64 KB까지 가능합니다 — 대부분의 README와 블로그 글이 여기에 해당합니다. 200페이지 분량의 매뉴얼이라면 챕터별로 나눠 처리하세요.
수정된 Markdown은 항상 유효한가요?
일반적인 손상에 대해서는 그렇습니다. 특수한 경우에는 Markdown 유효성 검사기로 추가 검증을 권장합니다.
관련 Markdown 도구
Markdown 수정은 작업의 한 단계일 뿐입니다. 이어서 사용할 만한 도구들을 소개합니다: