[VS Code / Antigravity] 마크다운(.md)을 노션·옵시디언처럼! WYSIWYG 라이브 에디터 설정 가이드

Posted on by ehrok

개발이나 문서 작업을 할 때 마크다운(Markdown, .md) 파일 자주 사용하시죠? 기존 VS Code 기본 환경에서는 코드창과 미리보기(Preview) 분할창을 2개 띄워두고 작업해야 해서 화면도 좁아지고 가독성이 떨어지는 불편함이 있었습니다.

오늘은 Google Antigravity나 VS Code에서 마크다운 파일을 노션(Notion)이나 옵시디언(Obsidian)처럼 실시간 시각화(WYSIWYG) 상태로 직접 편집하고, 상단 툴바 및 메타데이터(Properties) 박스까지 깔끔하게 띄우는 환경 설정 방법을 소개해 드립니다.

🔥 설정 후 주요 변화 (특징)

이 설정을 완료하면 .md 파일을 열었을 때 다음과 같은 스마트한 편집 환경이 제공됩니다:

  1. 상단 서식 툴바 지원: Bold, Italic, 굵기, 색상, 이미지, 표 생성 등을 클릭 한 번으로 조작
  2. YAML Frontmatter (Properties) 시각화: 파일 상단의 메타데이터(날짜, 태그, 프로젝트 등)가 노션 스타일의 깔끔한 카드 상자로 렌더링
  3. 좌측 목차(Outline) 자동 생성: 문서 내 헤딩(#, ##, ###)을 감지하여 클릭 시 해당 위치로 즉시 이동
  4. 실시간 라이브 렌더링 (WYSIWYG): 텍스트를 입력하는 즉시 결과물이 바로 보여 분할 창이 불필요

🛠️ 3분 만에 끝내는 설정 방법

1단계: 필수 확장 기능(Extension) 설치

  1. 에디터 좌측의 Extensions 아이콘 (Ctrl + Shift + X / Cmd + Shift + X)을 클릭합니다.
  2. 검색창에 **Markdown Editor**를 입력합니다.
  3. Markdown Editor (Vditor 기반 / zaaack 또는 cweijan 제공) 확장을 [Install] 합니다.

2단계: .md 파일의 기본 편집기로 지정하기

확장 프로그램을 설치한 후, 마크다운 파일을 클릭했을 때 항상 이 뷰어로 열리도록 기본값(Default)을 설정해야 합니다.

💡 [방법 A] 우클릭 메뉴로 설정 (가장 간편한 방법)

  1. 좌측 파일 탐색기에서 아무 .md 파일이나 마우스 우클릭합니다.
  2. 메뉴에서 Open With... (한글: 연결 프로그램...)를 선택합니다.
  3. 하단의 Configure default editor for '*.md'..." (한글: '*.md'에 대한 기본 편집기 구성...)을 클릭합니다.
  4. 목록에서 **Markdown Editor**를 선택하면 완료!

💡 [방법 B] settings.json 설정에 직접 추가

설정 파일에 직접 등록하고 싶다면 settings.json에 아래 구문을 추가해 주세요:

"workbench.editorAssociations": {
  "*.md": "zaaack.markdown-editor"
}

💡 유용한 실무 팁 (Q&A)

Q. 원본 마크다운 코드(raw text)를 수정하고 싶을 땐 어떻게 하나요?

  • 상단 파일 탭을 마우스 우클릭 후 **Open With... → Text Editor**를 선택하면 익숙한 원본 코드 편집기로 즉시 돌아갈 수 있습니다. 언제든 원하는 모드로 전환 가능합니다!

Q. 옵시디언(Obsidian) 노트와도 호환되나요?

  • 네! 옵시디언에서 사용하는 YAML 속성(date, tags, type 등)과 태그(#meeting, #project 등)가 그대로 깔끔한 시각화 카드로 표시되므로, 옵시디언 볼트(Vault)를 VS Code/Antigravity와 병행해서 쓰시는 분들께 강력 추천합니다.

🎯 마무리하며

이제 VS Code와 Antigravity에서도 노션이나 옵시디언 부럽지 않은 쾌적한 마크다운 문서 작성 환경을 누려보세요!

AI 코딩 어시스턴트를 팀 전용 비서로 만드는 법

Posted on by ehrok

Antigravity, Claude Code, GitHub Copilot 커스터마이징 비교

코딩 경험 없이도 AI를 “우리 팀만의 비서”로 바꿀 수 있다. 핵심은 3가지 파일 구조에 있다.

왜 커스터마이징인가?

ChatGPT, Gemini, Claude… 어떤 AI를 써도 결국 같은 문제에 부딪힌다:

  • “우리 팀 이름도 모르면서 뭘 도와줘?”
  • “매번 배경 설명부터 해야 하나?”
  • “어제 한 대화를 오늘은 기억 못 하네?”

이 문제의 해결책이 바로 AI 코딩 어시스턴트의 커스터마이징 시스템이다. Google의 Antigravity, Anthropic의 Claude Code, GitHub Copilot — 이 세 가지 모두 파일 기반으로 AI의 행동을 정의할 수 있는 구조를 갖추고 있다.

3대 AI 코딩 어시스턴트 커스터마이징 구조

1. 규칙 파일 — AI의 “헌법”

매 대화마다 자동으로 적용되는 기본 규칙이다. AI의 정체성, 행동 규칙, 팀 정보를 여기에 쓴다.

Antigravity Claude Code GitHub Copilot
파일명 GEMINI.md CLAUDE.md .github/copilot-instructions.md
위치 워크스페이스 루트 워크스페이스 루트 .github/ 폴더
형식 Markdown Markdown Markdown
적용 범위 모든 대화 모든 대화 모든 대화

규칙 파일에 들어가는 것들:
– AI의 이름과 정체성
– 팀 구성원 테이블 (이름, ID, 이메일)
– 사용자 자동 식별 규칙
– 반드시 지킬 것 (MUST) / 절대 하지 말 것 (NEVER)
– 참조할 파일 경로
– 출력 형식 기본값 (날짜 형식, 파일명 규칙 등)

2. Skills — AI의 “업무 매뉴얼”

특정 키워드에 반응하여 자동으로 로드되는 전문 작업 지시서다.

Antigravity Claude Code GitHub Copilot
경로 .agent/skills/ .agent/skills/ 없음
파일 SKILL.md SKILL.md —
로드 방식 의미 기반 자동 매칭 의미 기반 자동 매칭 —

Antigravity와 Claude Code는 .agent/skills/ 구조가 동일하다. 한 번 만들면 두 AI 모두에서 작동한다.

스킬 예시:
– “주간 로그 쓰자” → weekly-log 스킬 → 인터뷰 형식으로 주간 로그 작성
– “내 할 일 보여줘” → my-dashboard 스킬 → 업무 대시보드 생성
– “회의록 정리해줘” → meeting-note 스킬 → 구조화된 회의록 생성

각 SKILL.md에는 YAML 메타데이터로 트리거 키워드를 정의한다:

---
name: weekly-log
description: 팀원의 주간 업무를 인터뷰 형식으로 물어보고 구조화된 주간 로그를 생성한다. 주간 로그, 이번 주 한 일, 위클리 로그 등의 요청에 반응한다.
---

AI는 사용자의 자연어 요청과 이 description을 의미적으로 매칭해서 관련 스킬을 자동으로 찾아 참조한다.

3. Knowledge Base — AI의 “참고 자료”

AI가 상시 참조하는 지식 베이스다.

Antigravity Claude Code GitHub Copilot
경로 .context/ .context/ 없음
자동 참조 ✅ ✅ ❌
형식 Markdown Markdown —

Knowledge Base에 넣을 것들:
– team-info.md — 팀 기본 정보, 구성원, 미션
– folder-guide.md — 폴더 구조와 용도 정의
– project-glossary.md — 업무 용어 사전

Antigravity 기반 워크플로우

전체 흐름

사용자 질문 입력
│
├─ ① GEMINI.md 항상 적용 (규칙/정체성)
│ "한국어로 응답, 록님이라 호칭, 🏗️ 이모지 사용"
│
├─ ② .agent/skills/ 키워드 매칭
│ "주간 로그 쓰자" → weekly-log/SKILL.md 자동 로드
│
└─ ③ .context/ 필요 시 참조
│ 팀 정보, 폴더 가이드, 용어 사전
│
▼
AI 응답 생성

실제 사용 시나리오

시나리오 1: 주간 로그 작성

사용자: "주간 로그 쓰자"
│
├─ GEMINI.md → 사용자를 "록 팀장"으로 식별
├─ weekly-log/SKILL.md → 인터뷰 형식 절차 로드
└─ .context/team-info.md → 팀 맥락 참조
│
AI: "록님, 이번 주(W07) 주간 로그를 작성할게요!
이번 주에 한 일을 편하게 말씀해주세요."
│
사용자: "OOO 현안보고, AI비서환경 구축"
│
AI: [구조화된 주간 로그 생성 → 1 Note/1A/2026-W07-log.md 저장]

시나리오 2: 업무 대시보드

사용자: "오늘 할 일 정리해줘"
│
├─ my-dashboard/SKILL.md → 대시보드 템플릿 로드
└─ Daily Notes, Work 폴더 → 진행 중 업무 파악
│
AI: [마감 임박 태스크, 진행 중 업무, 우선순위 제안]

워크스페이스 구조

📁 워크스페이스 루트/
│
├── GEMINI.md ← Antigravity 규칙 (항상 적용)
├── CLAUDE.md ← Claude Code 규칙 (항상 적용)
│
├── .agent/skills/ ← 스킬 모듈 (공통)
│ ├── weekly-log/SKILL.md
│ ├── my-dashboard/SKILL.md
│ └── meeting-note/SKILL.md
│
├── .context/ ← Knowledge Base (공통)
│ ├── team-info.md
│ ├── folder-guide.md
│ └── project-glossary.md
│
├── 1 Note/ ← Obsidian 노트
├── 2 Work/ ← 업무 데이터
└── ...

비교 요약: 어떤 AI를 써야 할까?

항목 Antigravity Claude Code GitHub Copilot
규칙 파일 ✅ GEMINI.md ✅ CLAUDE.md ✅ copilot-instructions.md
스킬 시스템 ✅ .agent/skills/ ✅ .agent/skills/ ❌
Knowledge Base ✅ .context/ ✅ .context/ ❌
의미 기반 스킬 로딩 ✅ ✅ ❌
비용 무료 (프리뷰) 무료 (프리뷰) 유료 ($10~19/월)
IDE Antigravity 앱 VS Code / 터미널 VS Code
비개발자 친화도 ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐

핵심 포인트: Antigravity와 Claude Code는 .agent/skills/와 .context/를 공유한다. 규칙 파일(GEMINI.md / CLAUDE.md)만 각각 만들면, 나머지 스킬과 지식 베이스는 두 AI가 동일하게 사용한다.

시작하는 법 (비개발자용)

  1. 규칙 파일 만들기 (10분)

– GEMINI.md에 AI 이름, 팀원 정보, 행동 규칙 작성
– 마크다운 문법일 뿐, 코딩 아님

  1. Knowledge Base 세팅 (20분)

– .context/ 폴더에 팀 정보, 폴더 가이드, 용어 사전

  1. 스킬 1~2개 만들기 (30분)

– .agent/skills/[스킬명]/SKILL.md
– 트리거 키워드 + 실행 절차 + 출력 형식

  1. 테스트 (5분)

– “나는 누구야?” → 사용자 식별 확인
– “주간 로그 쓰자” → 스킬 작동 확인

총 소요: 약 1시간. 이후로는 매일 수 분의 대화로 업무를 정리할 수 있다.

이 글은 실제로 팀에서 Antigravity 기반 AI 비서를 구축하면서 작성했습니다.

2026-02-16