Obsidian Ko Style

Think:

• good: calm docs voice
• bad: stiff manual voice
• bad: playful onboarding voice
• bad: hypey marketing voice

By surface

Avoid

• Rhetorical questions: 어떻게 하냐고요? → state it directly
• Persuasive asides: 당연히, 물론이죠, 원하지 않으시죠?
• Hype: 진정한 힘, 최고의, 궁극의, 매우 중요해요 → 핵심 요소, 유용해요
• Chatty openers: 이제 시작해 볼까요?, 정말 강력해요!
• Translated idioms: 최우선 시민 → 핵심 요소 / 중심 개념
• Overly literal English sentence structure
• Motivational filler: 손쉽게, 놀랍게도, 멋지게, 완벽하게
• Emotional emphasis where none is needed

Help-site tone

For Help pages, prefer:

• clear statements
• short explanation before detail
• direct instructions
• modest claims
• concrete product terms

For Help pages, avoid:

• rhetorical setup
• “selling” the feature
• abstract philosophy when a concrete benefit will do
• dramatic contrast like “진정한 힘”, “만능 솔루션”, “최고의 도구”

Headings

Avoid sentence endings in headings. Use section labels, not full sentences.

✓ Obsidian이란 / 내 데이터를 직접 관리 / 리본 사용자 지정 ✗ 데이터를 직접 소유하고 관리해요

Body copy patterns

정의:   "X는 … 기능이에요."
기능:   "…할 수 있어요." / "…를 지원해요."
지시:   "…하세요." / "…를 선택하세요."
조건:   "…하면 …할 수 있어요."
권장:   "…하는 것이 좋아요." / "…를 권장해요."
설명:   "…하는 데 도움이 돼요."

Preferred sentence feel

Aim for:

• "Obsidian은 Markdown 편집기이자 지식 관리 앱이에요."
• "노트를 서로 연결하면 관계를 파악하는 데 도움이 돼요."
• "설정을 열고 외형을 선택하세요."

Avoid:

• "Obsidian은 Markdown 편집기이자 지식 관리 앱입니다."
• "어떻게 시작하냐고요?"
• "진정한 힘은 촘촘하게 연결된 지식 관리 체계를 관리하는 데 있어요."

Help site structure

1. What the feature is
2. What it does
3. How to use it
4. Notes or examples

Terminology

Keep fixed: Markdown, Canvas, CSS, API Transliterate: 볼트, 플러그인, 테마, 스니펫, 그래프 뷰, 백링크, 명령 팔레트

Avoid heavy abstractions — prefer plain phrasing:

• 노트를 정리하는 방식 (not 지식 관리 체계)
• 핵심 요소 (not 최우선 시민)
• 타사 (not 서드파티)
• 사용자 지정 (not 커스텀 / 커스터마이즈, unless part of a stable file name or legacy link target)

Preferred rewrites

Translation priority

1. Clarity
2. Natural Korean
3. Consistency
4. Closeness to source

A slightly less literal sentence that reads naturally is almost always the right call.

When clarity and literalness conflict, choose the version that sounds like polished Korean product documentation.