Markdown 편집기 사용 방법
Markdown은 간단한 문장부호로 구조를 표현하는 일반 텍스트입니다. 편집 원본과 읽기용 미리보기를 나란히 분리해 함께 확인할 수 있습니다.
작성과 미리보기
원본 영역을 수정하거나 신뢰하는 파일의 Markdown을 붙여넣으세요. 별도 변환 없이 입력에 따라 갱신됩니다. 데스크톱은 나란히, 좁은 화면은 세로로 쌓아 페이지 전체의 가로 넘침을 피합니다.
연한 시작 문서는 예시입니다. 수정하지 않은 예시를 선택하면 지워져 새로 시작합니다. 빈 채로 벗어나면 연한 예시가 돌아오지만 직접 입력한 내용은 유지합니다.
지원 Markdown
ATX 제목, 문단, 굵게·기울임, 인라인 코드, 코드 블록, 인용, 번호·글머리표 목록, 구분선, 인라인 링크, 머리글 한 행의 단순 파이프 표를 지원합니다. 가능한 곳에서 익숙한 CommonMark 방식을 따르지만 완전한 GFM 구현은 아닙니다.
중첩 목록, 참조 링크, 각주, 작업 목록 컨트롤, 수식, Mermaid, 구문 강조, HTML 블록, 사용자 확장은 제외됩니다. 게시 시스템이 특정 문법을 쓰면 원본 사본을 유지하세요.
안전성과 링크
원시 HTML은 실행하지 않고 텍스트로 표시합니다. http·https·mailto·루트 상대·문서 상대·페이지 내 조각 링크만 허용하며 javascript: 등 실행 가능한 방식은 클릭할 수 없습니다.
이미지 문법으로 이미지를 요청하지 않습니다. 대체 텍스트를 라벨로 표시해 문서를 붙여넣었다는 이유만으로 외부 호스트에 요청하지 않습니다. 따라서 이미지 크기·존재 여부를 시각적으로 확인하는 미리보기는 아닙니다.
원본 복사·저장
원본 복사는 HTML 미리보기가 아닌 정확한 Markdown 텍스트를 복사합니다. .md 저장도 같은 원본을 UTF-8 markdown-note.md로 내려받습니다. 줄바꿈·문장부호를 다른 편집기에서 수정할 수 있습니다.
계정, 클라우드 동기화, 자동 복구는 없습니다. 중요한 텍스트는 닫기 전에 파일로 저장하세요. Markdown 저장은 PDF·DOCX·패키지 웹사이트를 만들지 않습니다.
예시와 제한
‘## Release notes’는 2단계 제목, ‘- Fixed login’은 목록 항목, ‘[Docs](https://example.com/docs)’는 안전한 링크가 됩니다. 파이프 표에는 머리글 다음 ‘| --- | --- |’ 같은 구분 행이 필요합니다.
게시 환경의 문법·플러그인에 따라 표시가 다를 수 있으므로 최종 대상을 확인하세요. 매 편집마다 브라우저에서 갱신하므로 매우 큰 문서는 느릴 수 있습니다. 집중된 메모·문서용이며 협업 프로젝트·전체 IDE는 아닙니다.
여러 렌더러로 옮길 때 제목, 목록, 인용, 표 주위에 빈 줄을 넣으세요. 지원하지 않는 기호도 원본에는 읽을 수 있게 남으므로 모든 확장이 처리됐다고 가정하지 말고 미리보기와 비교하세요. 오래 보관할 문서는 작은 수정본을 별도 파일로 저장하거나 외부 버전 관리를 사용하세요.
FAQ
Markdown 원본을 바꾸나요?
아니요. 미리보기는 별도이며 복사·저장은 입력란의 정확한 내용을 사용합니다.
HTML을 붙여넣어도 되나요?
가능하지만 꺾쇠괄호를 이스케이프해 텍스트로 표시합니다. HTML·스크립트는 실행하지 않습니다.
이미지가 왜 안 보이나요?
외부 이미지 로딩을 의도적으로 차단합니다. 이미지 호스트에 접속하지 않도록 대체 텍스트만 표시합니다.
어떤 링크를 클릭할 수 있나요?
HTTP, HTTPS, mailto, 상대 경로, 같은 페이지 조각을 허용합니다. 실행 가능하거나 모르는 URL 방식은 일반 텍스트입니다.
초안이 자동 저장되나요?
아니요. 닫기 전에 .md 저장을 사용하세요. 계정·클라우드 저장은 없습니다.