사쿠라 에디터 Markdown: .md 파일 편집과 미리보기, 저장 절차

먼저 결론: Markdown은 텍스트로 편집하고 최종 렌더러에서 미리 본다

사쿠라 에디터에서 Markdown을 사용하려면 .md 파일을 텍스트로 열고 제목, 목록, 링크, 강조, 코드 블록을 문법 그대로 입력합니다. 파일 형식별 설정은 색상과 줄바꿈 표시를 읽기 쉽게 만들 수 있지만 Markdown 렌더러의 결과까지 보장하지는 않습니다. 공식 사쿠라 에디터 프로젝트에도 Markdown을 로컬에서 확인하는 방법이 안내되어 있으므로, 해당 방법이나 프로젝트의 미리보기를 별도 단계로 사용하세요.

.md 파일을 열고 편집하는 기본 절차

긴 문서와 미리보기를 동시에 고치기보다 짧은 예제로 시작하세요. 제목 하나, 문단 하나, 목록, 링크, 코드 블록을 포함하면 충분합니다. 기존 README나 사양서를 열 때는 저장하기 전에 작업용 복사본을 만드세요. 인코딩이나 줄바꿈을 선택한 결과 파일 전체가 예상보다 많이 바뀌어도 돌아갈 지점을 남길 수 있습니다.

.md 확장자만으로 가장 적절한 색상이나 줄바꿈 표시가 자동으로 적용된다고 보기는 어렵습니다. 먼저 원본이 읽기 쉬운지 확인하고 제목 기호와 본문, 링크와 대상, 코드 구분자와 코드 내용을 나눠서 보세요. 빈 문서보다 실제로 자주 다루는 파일과 비슷한 샘플로 설정을 검증하는 편이 좋습니다.

1. 복사본 만들기중요한 README나 사양서를 편집하기 전에 작업용 복사본을 저장합니다.
2. 작은 예제 작성제목, 목록, 링크, 인라인 코드, 코드 블록을 넣습니다.
3. 문법 확인빈 줄, 들여쓰기, 백틱, 링크 괄호, 이미지 경로를 점검합니다.
4. 저장 형식 선택저장소의 인코딩과 줄바꿈 규칙에 맞추고 저장 후 다시 엽니다.

Markdown 미리보기는 어디에서 확인할까

미리보기 방법을 고르기 전에 최종 표시 대상을 정하세요. GitHub용 README라면 GitHub나 호환되는 로컬 흐름에서 확인해야 합니다. 정적 문서 사이트는 다른 Markdown 엔진과 확장 문법을 사용할 수 있습니다. 사쿠라 에디터는 원본 편집, 검색, 검토에 집중하고 렌더러를 분리하면 특정 시스템의 확장 기능을 일반 문법으로 오해하는 일을 줄일 수 있습니다.

미리보기 결과가 이상하면 전체를 다시 쓰기 전에 원본을 확인하세요. 빠진 빈 줄, 과한 들여쓰기, 닫히지 않은 백틱, 링크 괄호, 상대 이미지 경로를 순서대로 봅니다. 이어서 미리보기 도구가 사쿠라 에디터에서 검토한 것과 같은 저장 파일을 읽었는지도 확인하세요.

1. 대상 정하기GitHub, Wiki, 특정 문서 사이트 중 실제로 표시될 곳을 결정합니다.
2. 원본 저장복사본을 남기고 대상이 요구하는 인코딩과 줄바꿈을 적용합니다.
3. 미리보기 실행공식 Wiki의 로컬 확인 방법이나 프로젝트의 렌더러를 사용합니다.
4. diff 검토수정 후 원본을 비교해 의도한 문법만 바뀌었는지 확인합니다.

흔한 실수와 안전한 진단 순서

흔한 실수는 사쿠라 에디터의 문법 색상을 렌더링 결과의 증거로 보는 것입니다. 또 다른 실수는 미리보기 문제를 고치려고 전체 치환을 실행해 링크, 코드 구분자, 표 구분선까지 바꾸는 것입니다. 문제가 생긴 가장 작은 구간을 복사하고 문자와 빈 줄을 비교하면서 한 번에 하나씩 수정하세요. 미리보기와 diff가 일치할 때까지 원본을 보관합니다.

Markdown 설정을 다른 PC로 옮길 때는 파일 형식별 설정만 필요한지, 사쿠라 에디터 전체 설정이 필요한지 먼저 결정하세요. 이 사이트의 설정 내보내기, 문자 코드, 줄바꿈, diff 가이드는 서로 가까운 문제를 나눠 설명합니다. 시각적 선호, 파일 형식, 본문 변경을 분리하면 원인을 더 빨리 찾을 수 있습니다.