📌 한글 가독성을 개선해야 하는 이유
옵시디언의 기본 스타일은 영어 위주로 설계되어 있어, 한글 텍스트를 읽을 때 다음과 같은 불편함이 있습니다:
- 양쪽 정렬(Justify): 단어 간격이 불규칙하게 벌어져 가독성이 떨어집니다
- 글자 단위 줄바꿈: “옵시디언”이 “옵시/디언”처럼 의미 없는 위치에서 끊겨 읽기 불편합니다
이 CSS는 한글의 자연스러운 읽기 경험을 위해 왼쪽 정렬과 단어 기준 줄바꿈(keep-all) 을 적용합니다.
📝 CSS 코드
korean-typography.css라는 파일명으로 CSS 스니펫을 저장합니다.
/* =========================================================
Obsidian 한글 스타일 패치
- 대상: 읽기 모드, 에디트 모드, 라이브 프리뷰
- 효과: 왼쪽 정렬, 단어 기준 줄바꿈 (keep-all)
========================================================= */
/* 읽기 모드 (Reading View) & 내보내기 화면 */
.markdown-preview-view,
.markdown-rendered {
text-align: left; /* 왼쪽 정렬 */
word-break: keep-all; /* 단어 기준 줄바꿈 (한글) */
overflow-wrap: break-word; /* 긴 영단어 등은 강제 줄바꿈 */
}
/* 편집 모드 & 라이브 프리뷰 (Source Mode & Live Preview) */
.markdown-source-view .cm-content,
.markdown-source-view .cm-scroller {
text-align: left; /* 왼쪽 정렬 */
word-break: keep-all; /* 단어 기준 줄바꿈 */
}
/* 표 내부에서는 keep-all 해제 (레이아웃 보호) */
.markdown-preview-view table,
.markdown-rendered table {
word-break: break-word;
}
/* (선택 사항) 제목(Header)에도 강제 적용이 필요한 경우 주석 해제 */
/*
h1, h2, h3, h4, h5, h6 {
word-break: keep-all !important;
}
*/🔧 적용 방법
1단계: CSS 스니펫 폴더 열기
옵시디언 설정에서 CSS 스니펫 폴더를 엽니다:
- 설정(
⌘+,) 클릭 - 에디터 → CSS 스니펫 탭 클릭
- 스니펫 폴더 열기 버튼 클릭
이제 운영체제의 파일 탐색기가 스니펫 폴더를 엽니다.
2단계: CSS 파일 저장
스니펫 폴더에 korean-typography.css 파일을 생성하고 위 코드를 붙여넣습니다.
3단계: 스니펫 활성화
옵시디언으로 돌아와서:
- 설정 → 에디터 → CSS 스니펫 탭
- 새로고침 버튼 클릭 (목록에
korean-typography가 나타납니다) korean-typography옆의 토글 스위치 켜기
📸 적용 전/후 비교
적용 전

양쪽 정렬로 인해 단어 간격이 불규칙하고, “옵시/디언”처럼 의미 없는 위치에서 줄이 바뀝니다.
적용 후

왼쪽 정렬로 깔끔해지고, 단어 단위로 줄바꿈이 되어 가독성이 크게 개선됩니다.
💡 추가 팁
- 테마 적용 후에도 동작: 이 스니펫은 대부분의 테마와 호환됩니다
- 일부 테마에서 강제 적용이 필요한 경우: 제목 요소(
h1~h6) 관련 주석을 해제하면 됩니다 - 표 내부는 예외: 표의 레이아웃이 깨지는 것을 방지하기 위해 표 안에서는 일반 줄바꿈을 유지합니다