Skip to main content

마크다운으로 강의 노트와 프롬프트를 깔끔하게 정리하기

Views 466약 11분생성형 AI 활용

마크다운은 '예쁜 문서'보다 '오래 살아남는 문서'를 위한 기술입니다

옵시디언을 처음 쓰면 이런 생각이 들 수 있습니다.

"그냥 메모장처럼 쓰면 안 되나요? 꼭 마크다운을 배워야 하나요?"

물론 그냥 써도 됩니다. 옵시디언은 빈 노트를 만들고 바로 타이핑할 수 있는 도구입니다. 하지만 우리 커뮤니티처럼 강의자료, 수강생 질문, AI 프롬프트, 실습 결과, 도구 리뷰를 함께 모으려면 이야기가 조금 달라집니다. 같은 내용을 쓰더라도 어떤 문서는 다시 읽기 쉽고, 어떤 문서는 두 달 뒤에 열었을 때 암호처럼 느껴집니다.

마크다운은 문서를 복잡하게 꾸미는 기술이 아닙니다. 오히려 반대입니다. 글자 몇 개로 제목, 목록, 체크박스, 표, 코드블록, 링크를 표현하는 아주 단순한 작성 방식입니다. 워드처럼 메뉴를 찾지 않아도 되고, 노션처럼 특정 서비스 안에 갇히지도 않습니다. 옵시디언의 노트는 내 컴퓨터 폴더에 저장되는 일반 텍스트 기반의 .md 파일이며, 옵시디언은 이런 열린 파일 형식을 사용하기 때문에 장기적으로 내 데이터를 내가 소유하기 쉽습니다.1

이 말은 꽤 중요합니다. 우리가 오늘 작성하는 강의 노트는 옵시디언 안에서만 살아 있는 특수한 문서가 아닙니다. 나중에 GitHub에 올릴 수도 있고, 다른 마크다운 편집기에서 열 수도 있고, AI에게 읽혀 요약·분류·재구성하게 할 수도 있습니다. 잘 정리된 마크다운 노트는 사람에게도 친절하고, AI에게도 친절한 커뮤니티 자산이 됩니다.

이번 장의 목표는 모든 마크다운 문법을 외우는 것이 아닙니다. AI 활용 강사 커뮤니티가 실제로 자주 쓰게 될 문법만 골라, 강의 준비와 협업에 바로 적용하는 것입니다.

마크다운으로 강의 노트와 프롬프트를 깔끔하게 정리하기

옵시디언 노트는 사실 평범한 .md 파일입니다

먼저 아주 중요한 사실부터 확인하겠습니다. 옵시디언에서 노트를 하나 만들면, 내 컴퓨터의 볼트 폴더 안에 .md 파일이 생깁니다. .md는 Markdown의 줄임말입니다. 예를 들어 20_프롬프트 폴더에 블로그_초안_작성_프롬프트.md라는 노트를 만들면 실제 파일 구조는 대략 이렇게 됩니다.

AI강사커뮤니티_볼트
└─ 20_프롬프트
   └─ 블로그_초안_작성_프롬프트.md

이 파일은 옵시디언이 없어도 일반 텍스트 편집기로 열 수 있습니다. 메모장, VS Code, Typora, GitHub 웹 화면에서도 내용을 볼 수 있습니다. 옵시디언은 로컬 폴더의 마크다운 파일을 지식베이스처럼 다루는 방식으로 작동하며, 이런 구조 덕분에 폴더 백업이나 변경 이력 관리와도 잘 어울립니다.2

비전공자 입장에서 이것을 이렇게 이해하면 쉽습니다.

옵시디언은 "문서를 담는 앱"이라기보다 "내 컴퓨터 폴더에 있는 마크다운 문서를 보기 좋게 열어주는 작업실"입니다. 문서의 주인은 옵시디언이 아니라 우리입니다. 그래서 우리가 문서를 어떤 형식으로 쓰느냐가 중요합니다.

예를 들어 아무 규칙 없이 이렇게 적어두면 어떨까요?

오늘 강의에서 나온 질문들. 어떤 분이 챗지피티가 거짓말하는 문제 물어봄. 또 어떤 분은 이미지 생성 저작권 궁금해함. 다음에 보강해야 함. 프롬프트도 다시 정리.

당장은 알아볼 수 있습니다. 하지만 한 달 뒤에는 어떤 강의였는지, 누가 정리했는지, 무엇을 해야 하는지 애매합니다. 반면 같은 내용을 마크다운 구조로 정리하면 훨씬 명확해집니다.

# 수강생 질문 정리 - AI 입문 1회차

## 작성 정보
- 작성일: 2026-05-06
- 작성자: 김OO
- 관련 강의: [[AI 입문 1회차]]

## 나온 질문
- ChatGPT가 그럴듯한 거짓말을 할 때 어떻게 설명할 것인가?
- AI 이미지 생성물을 강의 교재에 넣어도 되는가?

## 다음 행동
- [ ] 환각 현상 설명용 쉬운 비유 만들기
- [ ] 이미지 생성 도구별 상업적 이용 조건 확인하기
- [ ] 다음 강의 FAQ에 반영하기

#내부공유 #검토필요

내용은 거의 같습니다. 하지만 두 번째 노트는 누가 봐도 문서의 목적과 다음 행동을 파악할 수 있습니다. 이것이 우리가 마크다운을 배우는 이유입니다.

가장 먼저 익힐 기본 문법 7가지

마크다운 문법은 많지만, 처음부터 전부 외울 필요는 없습니다. 우리 커뮤니티가 매일 쓰게 될 기본 문법은 제목, 목록, 체크박스, 굵게, 인용문, 코드블록, 구분선 정도입니다. 옵시디언은 표준 마크다운에 더해 [[내부 링크]], 콜아웃, 체크박스 같은 기능을 편하게 사용할 수 있습니다.3

제목과 소제목: #으로 문서의 뼈대를 세웁니다

마크다운에서 제목은 #으로 만듭니다. #이 하나면 큰 제목, ##는 중간 제목, ###는 더 작은 제목입니다. 중요한 점은 # 뒤에 반드시 한 칸을 띄는 것입니다.

# 강의 노트 제목

## 강의 목표

## 핵심 설명

### 예시

## 다음 행동

노트 하나 안에서는 보통 # 제목을 한 번만 쓰고, 그 아래를 ##와 ###로 나누면 충분합니다. 제목을 잘 나누면 사람도 읽기 쉽고, AI에게 "이 노트를 요약해줘"라고 했을 때도 구조를 더 잘 파악합니다.

강의 노트에서는 이런 흐름이 좋습니다.

# ChatGPT 입문 강의 노트

## 오늘의 목표

## 수강생이 헷갈릴 만한 개념

## 설명에 사용할 비유

## 실습 순서

## 다음 강의에서 보완할 점

제목은 문서의 내비게이션입니다. 글을 길게 쓰기 전에 먼저 제목만 세워도 절반은 정리된 것입니다.

목록: 생각을 한 줄씩 분리합니다

순서가 중요하지 않은 항목은 -를 사용합니다.

- 강의 주제 정하기
- 실습 예제 만들기
- 수강생 질문 예상하기

순서가 중요한 절차는 숫자를 사용합니다.

1. ChatGPT에 로그인한다.
2. 새 대화를 연다.
3. 실습 프롬프트를 붙여넣는다.
4. 결과를 복사해 노트에 저장한다.

강의 실습 안내문에서는 숫자 목록이 특히 유용합니다. 수강생은 "무엇을 먼저 해야 하지?"에서 자주 막히기 때문입니다. 순서 목록을 쓰면 강의 중 안내도 쉬워집니다.

체크박스: 노트를 실행 도구로 바꿉니다

체크박스는 - [ ]로 만듭니다. 완료한 항목은 - [x]로 표시합니다.

## 강의 준비 체크리스트

- [ ] 강의안 최종 확인
- [ ] 실습용 계정 로그인 테스트
- [ ] 예시 프롬프트 복사본 준비
- [ ] 수강생 배포용 링크 확인
- [x] 줌 회의실 예약

체크박스는 단순한 할 일 목록이 아닙니다. 커뮤니티 협업에서는 "누가, 언제까지, 무엇을 끝냈는지" 확인하는 작은 프로젝트 관리 도구가 됩니다.

## 실행 항목

| 할 일 | 담당자 | 마감일 | 상태 |
|---|---|---|---|
| 입문 강의 실습 프롬프트 정리 | 김OO | 2026-05-10 | 진행중 |
| 수강생 FAQ 초안 작성 | 이OO | 2026-05-12 | 대기 |
| 공개 후보 자료 검토 | 박OO | 2026-05-15 | 대기 |

표가 어렵게 느껴진다면 처음에는 체크박스만 써도 충분합니다. 익숙해지면 담당자와 마감일을 표로 추가하면 됩니다.

굵게와 하이라이트: 중요한 말만 조용히 강조합니다

굵게는 내용으로 표시합니다.

AI 도구 설명에서 가장 중요한 것은 수강생의 현재 수준에 맞는 비유입니다.

옵시디언에서는 ==내용==으로 하이라이트도 할 수 있습니다.

==이 프롬프트는 개인정보를 넣지 않는 방식으로 수정해야 합니다.==

강조는 적게 쓸수록 힘이 있습니다. 한 문단에 모든 문장이 굵게 표시되어 있으면 아무것도 강조되지 않은 것과 같습니다. 강의 노트에서는 "나중에 반드시 확인할 문장"이나 "수강생에게 그대로 말할 핵심 문장"에만 사용하세요.

인용문: 수강생 발언과 참고 문장을 구분합니다

인용문은 >로 만듭니다.

> 수강생 질문: ChatGPT가 틀린 답을 자신 있게 말하면 어떻게 구분하나요?

강의 현장에서 나온 실제 질문이나 동료 강사의 코멘트를 적을 때 인용문을 쓰면 본문과 구분됩니다.

## 현장 반응

> 수강생 A: 프롬프트를 길게 쓰면 무조건 좋은 줄 알았어요.

이 반응을 바탕으로 다음 강의에서는 "긴 프롬프트보다 명확한 프롬프트"라는 메시지를 먼저 설명한다.

단, 수강생 이름, 기관명, 민감한 사례가 들어간 내용은 조심해야 합니다. 내부 공유 노트라면 #내부공유를 붙이고, 공개 후보 노트라면 익명화 여부를 반드시 확인합니다.

코드블록: 프롬프트 원문과 AI 응답을 안전하게 보관합니다

AI 강사에게 가장 중요한 문법 중 하나가 코드블록입니다. 코드블록은 세 개의 백틱으로 감싸서 만듭니다.

```text
여기에 프롬프트 원문을 그대로 붙여넣습니다.
줄바꿈과 문장 구조가 유지됩니다.
```

왜 프롬프트를 코드블록에 넣어야 할까요? 일반 본문에 붙여넣으면 제목이나 목록 문법이 섞여 문서 구조가 흐트러질 수 있습니다. 코드블록에 넣으면 "이 안의 내용은 실행하거나 분석할 원문"이라는 뜻이 분명해집니다.

예를 들어 프롬프트 실험 노트는 이렇게 작성할 수 있습니다.

## 프롬프트 원문

```text
당신은 초보자를 돕는 AI 활용 강사입니다.
아래 주제를 60분 입문 강의 흐름으로 구성해주세요.

주제: 업무 메일 작성에 ChatGPT 활용하기
대상: 생성형 AI를 처음 쓰는 사무직 근로자
포함할 것: 실습 2개, 주의사항 3개, 마무리 과제
```

## 출력 결과 요약

AI가 3단계 강의 흐름을 제안했다. 실습은 적절했지만 주의사항이 너무 일반적이었다.

## 개선 방향

다음 버전에서는 "개인정보를 입력하지 말 것"과 "회사 내부 문서를 그대로 붙여넣지 말 것"을 명시한다.

프롬프트는 문장 하나만 바뀌어도 결과가 달라집니다. 그래서 원문을 보존하는 습관이 중요합니다.

구분선: 실험 버전을 나눕니다

구분선은 ---로 만듭니다.

## 1차 실험

결과가 너무 길었다.

---

## 2차 실험

분량 조건을 추가하니 결과가 좋아졌다.

프롬프트 실험 노트에서는 1차, 2차, 3차 결과가 계속 쌓입니다. 구분선을 쓰면 버전 간 경계가 선명해집니다.

강의 노트는 '나중에 다시 강의할 나'를 위해 씁니다

강의 노트는 단순한 대본이 아닙니다. 강의 전에는 준비 도구이고, 강의 중에는 진행 지도이며, 강의 후에는 개선 기록입니다. 그래서 강의 노트에는 적어도 "강의 정보, 목표, 흐름, 실습, 질문, 회고"가 들어가야 합니다.

이전 장에서 만든 10_강의자료 폴더 안에 AI입문-1회차-강의노트.md를 만들고 아래 템플릿을 붙여넣어봅시다.

# AI입문 1회차 강의 노트

## 작성 정보
- 작성일: 2026-05-06
- 작성자: 
- 관련 강의: AI 입문
- 공개 구분: 내부공유

## 강의 목표
수강생이 생성형 AI의 기본 개념을 이해하고, 간단한 프롬프트로 결과를 만들어본다.

## 대상 수강생
- AI 도구를 처음 사용한다.
- ChatGPT 계정 생성 경험이 없거나 적다.
- 업무 활용 사례를 궁금해한다.

## 오늘의 핵심 메시지
AI는 정답 자판기가 아니라 초안을 함께 만드는 협업 도구입니다.

## 강의 흐름
1. 생성형 AI를 쉬운 비유로 설명하기
2. ChatGPT 화면 구성 보여주기
3. 좋은 프롬프트와 애매한 프롬프트 비교하기
4. 업무 메일 초안 작성 실습하기
5. 결과 검토와 수정 방법 안내하기

## 실습 안내
- [ ] 실습 프롬프트 배포
- [ ] 수강생 결과 확인
- [ ] 좋은 결과 사례 2개 공유
- [ ] 자주 나온 오류 기록

## 수강생 질문
> 질문:

답변 메모:

## 강의 후 회고
### 잘된 점

### 아쉬웠던 점

### 다음 강의에서 바꿀 점

## 연결 노트
- 관련 프롬프트: [[업무메일_초안_작성_프롬프트]]
- 관련 질문: [[ChatGPT_환각현상_설명질문]]

#내부공유

이 템플릿은 완벽한 양식이 아닙니다. 하지만 강의 준비에 필요한 최소한의 뼈대를 제공합니다. 특히 "오늘의 핵심 메시지"를 한 문장으로 적는 습관이 중요합니다. 강의가 산만해질 때 이 한 문장이 중심을 잡아줍니다.

여기서 [[업무메일_초안_작성_프롬프트]]처럼 대괄호 두 개로 감싼 부분은 옵시디언의 내부 링크입니다. 아직 해당 노트가 없어도 괜찮습니다. 클릭하면 새 노트를 만들 수 있습니다. 강의 노트와 프롬프트 노트가 이렇게 연결되기 시작하면, 볼트는 단순한 폴더 묶음이 아니라 살아 있는 지식망이 됩니다.

수강생 질문 노트는 FAQ의 씨앗입니다

강의 현장에서 나온 질문은 그날만의 에피소드가 아닙니다. 같은 질문이 반복된다면 그것은 다음 강의에서 반드시 설명해야 할 핵심 포인트입니다. 그래서 질문은 회의록 한구석에 묻어두지 말고, 가능하면 하나의 질문을 하나의 노트로 남기는 것이 좋습니다.

30_사례모음/수강생질문 폴더에 질문 노트를 만들어봅시다.

# 질문 - ChatGPT가 틀린 답을 말할 때 어떻게 확인하나요

## 작성 정보
- 작성일: 2026-05-06
- 작성자:
- 관련 강의: [[AI입문 1회차 강의 노트]]
- 공개 구분: 공개후보

## 질문 원문
> ChatGPT가 틀린 답을 자신 있게 말하면 초보자는 어떻게 구분하나요?

## 질문이 나온 상황
AI 입문 강의에서 첫 실습 후 나온 질문이다. 수강생이 결과를 그대로 믿어도 되는지 불안해했다.

## 쉬운 답변 초안
ChatGPT의 답변은 "검토가 필요한 초안"으로 보는 것이 안전합니다. 특히 숫자, 법률, 의학, 정책, 최신 정보는 반드시 공식 자료나 신뢰할 수 있는 출처로 확인해야 합니다.

## 다음 강의에 반영할 내용
- [ ] AI 환각 현상을 쉬운 비유로 설명하기
- [ ] 확인이 필요한 답변과 바로 활용 가능한 답변 구분하기
- [ ] 출처 확인 실습 추가하기

## 연결 노트
- [[AI_환각현상_쉬운비유]]
- [[출처확인_실습안내]]

#공개후보 #검토필요

이런 질문 노트가 쌓이면 나중에 자주 묻는 질문.md를 만들 수 있습니다. 처음부터 FAQ를 완성하려고 하지 않아도 됩니다. 질문 하나를 잘 저장하는 것만으로도 FAQ의 재료가 생깁니다.

중요한 것은 질문 원문을 그대로 공개하지 않는 것입니다. 수강생이 누구인지 추측할 수 있는 정보, 회사명, 고객사명, 개인 사정은 제거해야 합니다. 프롬프트 저장소를 운영하는 공개 사례에서도 민감 정보나 개인정보를 프롬프트 예시에 포함하지 말라고 안내합니다.4 우리 커뮤니티도 같은 원칙을 가져야 합니다.

프롬프트 실험 노트는 '재현 가능성'이 생명입니다

AI 프롬프트는 요리 레시피와 비슷합니다. "대충 맛있게 만들었다"는 기록만으로는 다른 사람이 따라 할 수 없습니다. 어떤 재료를 넣었는지, 어떤 도구를 썼는지, 몇 번 실패했는지, 무엇을 바꿨더니 좋아졌는지를 남겨야 합니다.

프롬프트 실험 노트에는 최소한 다음 정보가 들어가야 합니다.

# 프롬프트 실험 - 강의 목차 생성

## 작성 정보
- 작성일: 2026-05-06
- 작성자:
- 관련 강의: [[AI입문 1회차 강의 노트]]
- 공개 구분: 내부공유

## 실험 목적
초보자 대상 2시간 강의 목차를 빠르게 생성하고, 실습 중심으로 재구성한다.

## 사용 도구와 모델
- 도구: ChatGPT
- 모델: GPT 계열
- 실행 환경: 웹 브라우저

## 입력 자료
- 강의 대상: AI를 처음 접하는 사무직 근로자
- 강의 시간: 2시간
- 목표: 업무 메일 초안 작성, 요약, 아이디어 발산을 경험하게 하기

## 프롬프트 원문

```text
당신은 초보자를 돕는 AI 활용 강사입니다.
아래 조건에 맞춰 2시간짜리 입문 강의 목차를 작성해주세요.

대상: AI를 처음 접하는 사무직 근로자
강의 목표: 업무 메일 초안 작성, 문서 요약, 아이디어 발산을 경험하게 하기
조건:
- 설명보다 실습 비중을 높일 것
- 어려운 전문 용어는 피할 것
- 각 실습마다 예상 소요 시간을 적을 것

출력 결과 요약

AI가 5단계 목차를 제안했다. 전체 흐름은 좋았지만, 첫 설명 시간이 30분으로 길었다.

평가

항목평가메모
초보자 친화성좋음용어가 쉬웠다
실습 비중보통설명 시간이 길었다
바로 사용 가능성보통시간 배분 수정 필요

개선 버전 프롬프트

위 목차에서 설명 시간을 줄이고, 첫 20분 안에 수강생이 직접 결과물을 만들 수 있도록 다시 구성해주세요.
각 파트는 15분을 넘지 않게 나누고, 강사가 말할 안내 문장 예시도 포함해주세요.

다음 행동

  • 개선 버전으로 다시 실행하기

  • 실제 강의 흐름표에 반영하기

  • 수강생용 실습 안내문 만들기

#내부공유


이렇게 저장하면 다른 강사도 같은 실험을 재현할 수 있습니다. "이 프롬프트 괜찮았어요"가 아니라 "이 조건에서 이 도구로 실행했더니 이런 결과가 나왔고, 이 부분을 수정해야 합니다"라고 공유할 수 있습니다.

프롬프트 실험 노트에서 특히 중요한 부분은 평가입니다. AI 결과를 그대로 모아두기만 하면 자료 창고가 금세 쓰레기장이 됩니다. 좋은 결과인지, 어디가 부족한지, 다음 버전에서 무엇을 바꿀지 적어야 실험이 자산으로 바뀝니다.

## 도구 리뷰 노트는 강의 도입 여부를 판단하게 해줍니다

AI 강사 커뮤니티에는 새로운 도구 정보가 끊임없이 들어옵니다. 오늘은 이미지 생성 도구, 내일은 음성 합성 도구, 다음 주에는 자동화 도구가 등장합니다. 문제는 "신기하다"와 "강의에 쓸 만하다"가 다르다는 점입니다.

도구 리뷰 노트는 감상이 아니라 판단 기록이어야 합니다.

```markdown
# 도구 리뷰 - Gamma

## 작성 정보
- 작성일: 2026-05-06
- 작성자:
- 관련 강의: [[AI활용_콘텐츠제작_강의]]
- 공개 구분: 공개후보

## 도구 한 줄 설명
텍스트 입력을 바탕으로 발표자료 초안을 만들어주는 AI 기반 프레젠테이션 도구.

## 사용 목적
초보 수강생이 강의안이나 발표자료의 초안을 빠르게 만드는 실습에 적합한지 확인한다.

## 테스트 조건
- 무료 플랜 기준으로 테스트
- 한국어 입력 사용
- 10장 내외 발표자료 생성

## 좋았던 점
- 초안 생성 속도가 빠르다.
- 디자인을 어려워하는 수강생에게 진입 장벽이 낮다.
- 목차를 먼저 잡는 실습에 활용하기 좋다.

## 아쉬웠던 점
- 세부 내용의 정확성 검토가 필요하다.
- 무료 플랜 제한을 강의 전에 확인해야 한다.
- 결과물을 그대로 쓰기보다 수정 실습과 함께 써야 한다.

## 강의 활용 판단
| 항목 | 판단 |
|---|---|
| 초보자 적합성 | 높음 |
| 무료 사용 가능성 | 확인 필요 |
| 실습 안정성 | 보통 |
| 추천 강의 | 콘텐츠 제작 입문 |

## 다음 행동
- [ ] 무료 플랜 제한 최신 확인
- [ ] 수강생 실습용 예제 주제 3개 만들기
- [ ] 대체 도구와 비교하기

#공개후보 #검토필요

도구 리뷰에서 "무료 플랜 기준"을 따로 적는 이유는 우리 커뮤니티가 free tier를 중심으로 운영하기 때문입니다. 무료로 가능하다고 생각했던 기능이 어느 날 유료로 바뀌거나 제한될 수 있습니다. 그래서 도구 리뷰 노트에는 테스트 날짜와 조건을 꼭 남겨야 합니다.

표는 비교와 협업에 강합니다

마크다운 표는 처음 보면 조금 낯설지만, 한 번 익히면 강의 준비에 매우 유용합니다. 기본 형태는 이렇습니다.

| 항목 | 내용 | 비고 |
|---|---|---|
| 강의 대상 | AI 입문자 | 계정 생성부터 안내 |
| 강의 시간 | 2시간 | 실습 60분 이상 |
| 준비물 | 노트북 | 모바일만으로는 제한 있음 |

옵시디언에서는 이 표가 보기 좋게 표시됩니다. 표는 다음처럼 비교해야 하는 정보에 잘 맞습니다.

## 프롬프트 버전 비교

| 버전 | 바꾼 점 | 결과 | 판단 |
|---|---|---|---|
| v1 | 기본 요청만 입력 | 결과가 너무 일반적 | 보류 |
| v2 | 대상과 시간 추가 | 강의 흐름이 구체화됨 | 사용 가능 |
| v3 | 실습 조건 추가 | 현장 적용성이 높아짐 | 추천 |

커뮤니티 협업용 실행 노트도 표로 관리할 수 있습니다.

## 공개 자료 준비 현황

| 자료명 | 담당자 | 마감일 | 상태 | 결과 링크 |
|---|---|---|---|---|
| ChatGPT 입문 체크리스트 | 김OO | 2026-05-12 | 검토중 | [[ChatGPT_입문_체크리스트]] |
| 프롬프트 작성 예시 5개 | 이OO | 2026-05-15 | 작성중 | [[프롬프트_예시모음]] |
| 공개 전 점검표 | 박OO | 2026-05-16 | 대기 | [[공개자료_점검표]] |

표를 너무 복잡하게 만들 필요는 없습니다. 열이 6개를 넘어가면 읽기 어려워집니다. 초보자 단계에서는 할 일, 담당자, 마감일, 상태, 링크 정도면 충분합니다.

내부 링크로 노트끼리 대화하게 만들기

옵시디언의 강력함은 노트를 서로 연결할 때 드러납니다. 내부 링크는 [[노트 이름]]으로 만듭니다.

이 질문은 [[AI_환각현상_쉬운비유]] 노트와 연결된다.

다른 이름으로 보이게 하고 싶다면 |를 사용합니다.

자세한 설명은 [[AI_환각현상_쉬운비유|환각 현상 설명 노트]]를 참고한다.

링크를 만드는 순간 옵시디언은 두 노트의 관계를 기억합니다. A 노트에서 B 노트를 링크하면, B 노트의 백링크 영역에서 "어떤 노트가 나를 언급했는지" 볼 수 있습니다. 그래프 뷰를 열면 노트들이 점과 선으로 연결된 지도처럼 보입니다.

우리 커뮤니티에서는 내부 링크를 이렇게 활용하면 좋습니다.

## 연결 노트
- 관련 강의: [[AI입문 1회차 강의 노트]]
- 관련 프롬프트: [[업무메일_초안_작성_프롬프트]]
- 관련 질문: [[질문 - ChatGPT가 틀린 답을 말할 때 어떻게 확인하나요]]
- 관련 도구 리뷰: [[도구 리뷰 - Gamma]]

내부 링크의 목적은 멋진 그래프를 만드는 것이 아닙니다. 나중에 자료를 찾을 때 "이 강의와 연결된 질문이 뭐였지?", "이 프롬프트를 어디서 사용했지?", "이 도구 리뷰가 어떤 강의와 관련 있었지?"를 빠르게 추적하기 위한 것입니다.

좋은 링크는 기억을 대신합니다.

한 노트에 모든 것을 넣지 않는 연습

초보자들이 자주 하는 실수는 하나의 노트에 모든 내용을 몰아넣는 것입니다. AI강의자료.md라는 파일 하나에 강의 흐름, 프롬프트, 수강생 질문, 도구 리뷰, 회의 메모를 계속 붙여넣습니다. 처음에는 편합니다. 하지만 길이가 길어질수록 찾기 어려워지고, 링크하기도 어려워집니다.

우리는 "한 주제 한 노트" 원칙을 느슨하게 적용하겠습니다. 여기서 중요한 말은 "느슨하게"입니다. 너무 엄격하게 쪼개면 기록이 부담스러워집니다. 너무 크게 합치면 재사용이 어려워집니다.

기준은 간단합니다.

하나의 노트가 독립적으로 다시 쓰일 수 있다면 분리합니다. 예를 들어 업무메일_초안_작성_프롬프트는 여러 강의에서 재사용할 수 있으므로 별도 노트가 좋습니다. ChatGPT가 틀린 답을 말할 때 확인하는 법도 FAQ, 강의, 블로그 글에서 반복 활용될 수 있으므로 별도 노트가 좋습니다.

반대로 강의 당일의 짧은 진행 메모나 임시 아이디어는 하나의 강의 노트 안에 있어도 괜찮습니다.

예를 들어 이렇게 나누면 좋습니다.

10_강의자료
└─ AI입문
   └─ AI입문_1회차_강의노트.md

20_프롬프트
└─ 강의용
   └─ 업무메일_초안_작성_프롬프트.md

30_사례모음
└─ 수강생질문
   └─ 질문_ChatGPT가_틀린답을_말할때.md

30_사례모음
└─ 도구활용사례
   └─ 도구리뷰_Gamma.md

이렇게 하면 같은 프롬프트를 다른 강의 노트에서 링크할 수 있고, 같은 질문을 FAQ 자료로 재활용할 수 있습니다. 자료가 "복사해서 붙여넣는 덩어리"가 아니라 "연결해서 다시 쓰는 블록"이 됩니다.

공개용과 내부용은 처음부터 표시합니다

우리 커뮤니티는 일부 자료는 public으로 공개하고, 일부는 private하게 내부 공유하려고 합니다. 이 흐름은 뒤 장에서 GitHub 저장소 전략으로 자세히 다루겠지만, 마크다운 노트를 작성하는 지금부터 준비해야 합니다.

가장 쉬운 방법은 노트 위쪽에 메타정보를 적는 것입니다. 메타정보는 문서의 신분증입니다.

---
created: 2026-05-06
author: 김OO
related_class: AI 입문
visibility: internal
status: draft
---

이런 위쪽 정보 블록을 프론트매터라고 부릅니다. 초보자에게는 "문서 맨 위에 붙이는 관리 정보"라고 이해하면 됩니다. 반드시 모든 노트에 넣을 필요는 없지만, 공개 여부를 관리해야 하는 자료에는 매우 유용합니다.

우리 커뮤니티에서는 처음에 아래 정도만 써도 충분합니다.

---
created: 2026-05-06
author: 
related_class: 
visibility: internal
status: draft
---

visibility에는 public-candidate, internal, private처럼 적을 수 있습니다. 다만 너무 복잡한 값은 피하세요. 커뮤니티 전체가 같은 기준으로 쓰는 것이 더 중요합니다.

visibility: public-candidate

이렇게 적힌 노트는 공개 후보입니다. 아직 공개 확정은 아닙니다.

visibility: internal

이렇게 적힌 노트는 커뮤니티 내부 공유용입니다.

visibility: private

이렇게 적힌 노트는 개인적이거나 민감한 내용이므로 공유 저장소에 올리지 않는 것이 안전합니다.

나중에 Quartz 같은 무료 정적 사이트 생성 도구로 옵시디언 노트를 공개할 때도, 프론트매터의 publish: true 같은 값을 기준으로 공개할 문서만 골라내는 방식이 쓰입니다.5 지금은 기술 설정을 몰라도 됩니다. 다만 "공개 여부를 문서 안에 표시하는 습관"이 나중에 큰 사고를 막아준다는 점만 기억하면 됩니다.

커뮤니티 공통 템플릿 4종

이제 실제로 복사해서 쓸 수 있는 템플릿을 정리해보겠습니다. 이전 장에서 만든 50_템플릿 폴더에 아래 네 가지 파일을 만들어두면 좋습니다.

강의 노트 템플릿

파일명은 강의노트_템플릿.md로 저장합니다.

---
created: 
author: 
related_class: 
visibility: internal
status: draft
---

# 강의명

## 강의 정보
- 날짜:
- 대상:
- 인원:
- 강의 시간:

## 강의 목표

## 오늘의 핵심 메시지

## 강의 흐름
1. 
2. 
3. 

## 실습 안내
- [ ] 
- [ ] 
- [ ] 

## 수강생 질문
> 

## 강의 후 회고
### 잘된 점

### 아쉬웠던 점

### 다음에 바꿀 점

## 연결 노트
- 관련 프롬프트:
- 관련 질문:
- 관련 사례:

#내부공유

질문 노트 템플릿

파일명은 질문노트_템플릿.md로 저장합니다.

---
created: 
author: 
related_class: 
visibility: internal
status: draft
---

# 질문 - 

## 질문 원문
> 

## 질문이 나온 상황

## 쉬운 답변 초안

## 보완이 필요한 내용
- [ ] 
- [ ] 

## FAQ로 발전 가능성
- 공개 가능 여부:
- 익명화 필요 여부:
- 관련 자료:

## 연결 노트
- 관련 강의:
- 관련 프롬프트:

#내부공유 #검토필요

프롬프트 실험 노트 템플릿

파일명은 프롬프트실험_템플릿.md로 저장합니다.

---
created: 
author: 
related_class: 
visibility: internal
status: draft
---

# 프롬프트 실험 - 

## 실험 목적

## 사용 도구와 모델
- 도구:
- 모델:
- 실행 날짜:

## 입력 자료

## 프롬프트 원문

```text

```

## 출력 결과

```text

```

## 평가
| 항목 | 평가 | 메모 |
|---|---|---|
| 정확성 |  |  |
| 실용성 |  |  |
| 초보자 친화성 |  |  |

## 개선 버전

```text

```

## 다음 행동
- [ ] 
- [ ] 

#내부공유

도구 리뷰 노트 템플릿

파일명은 도구리뷰_템플릿.md로 저장합니다.

---
created: 
author: 
related_class: 
visibility: public-candidate
status: draft
---

# 도구 리뷰 - 

## 도구 한 줄 설명

## 사용 목적

## 테스트 조건
- 무료 플랜 기준:
- 테스트 날짜:
- 사용 환경:

## 좋았던 점

## 아쉬웠던 점

## 강의 활용 판단
| 항목 | 판단 | 메모 |
|---|---|---|
| 초보자 적합성 |  |  |
| 무료 사용 가능성 |  |  |
| 실습 안정성 |  |  |
| 추천 강의 |  |  |

## 다음 행동
- [ ] 
- [ ] 

#공개후보 #검토필요

템플릿은 문서를 대신 써주는 도구가 아닙니다. 기록을 시작하기 쉽게 만들어주는 출발선입니다. 처음에는 빈칸을 전부 채우지 못해도 괜찮습니다. 다만 작성일, 작성자, 관련 강의, 목적, 핵심 내용, 다음 행동만큼은 되도록 남기는 습관을 들이세요.

오늘의 실습: 노트 4개를 직접 만들어보기

이제 손을 움직일 차례입니다. 이번 장을 읽기만 하면 마크다운은 금방 잊어버립니다. 실제로 네 개의 노트를 만들어보면 감이 잡힙니다.

먼저 50_템플릿 폴더에 방금 소개한 템플릿 4개를 저장합니다. 그다음 아래 노트를 각각 하나씩 만들어보세요.

10_강의자료/AI입문/AI입문_1회차_강의노트.md
30_사례모음/수강생질문/질문_ChatGPT_검증방법.md
20_프롬프트/실험중/강의목차_생성_프롬프트실험.md
30_사례모음/도구활용사례/도구리뷰_발표자료AI.md

각 노트에는 다음 요소를 최소 한 번씩 넣어봅니다.

## 소제목
- 목록
- [ ] 체크박스
> 인용문
[[내부 링크]]

프롬프트 실험 노트에는 반드시 코드블록을 넣습니다.

```text
여기에 실제 프롬프트를 붙여넣습니다.
```

마지막으로 각 노트 맨 아래에 #공개후보, #내부공유, #검토필요 중 하나 이상을 붙여봅니다. 공개 가능성이 애매한 자료라면 일단 #검토필요를 붙이는 것이 안전합니다.

좋은 마크다운 노트의 기준

좋은 노트는 화려한 노트가 아닙니다. 다시 열었을 때 바로 이해되는 노트입니다. 다른 강사가 읽고 이어서 작업할 수 있는 노트입니다. AI에게 넣었을 때 제목, 목적, 원문, 결과, 평가를 구분해서 이해할 수 있는 노트입니다.

우리 커뮤니티의 마크다운 노트는 다음 기준을 만족하면 충분합니다.

- 제목만 봐도 무슨 노트인지 알 수 있다.
- 작성일, 작성자, 관련 강의가 남아 있다.
- 본문이 소제목으로 나뉘어 있다.
- 프롬프트 원문과 AI 응답이 코드블록으로 분리되어 있다.
- 다음 행동이 체크박스로 정리되어 있다.
- 관련 노트가 내부 링크로 연결되어 있다.
- 공개 여부가 태그나 메타정보로 표시되어 있다.

이 기준을 매번 완벽하게 지킬 필요는 없습니다. 하지만 중요한 강의자료, 공유할 프롬프트, 공개 후보 자료에는 가능하면 적용하세요. 이런 노트가 10개만 쌓여도 커뮤니티의 지식 수준이 달라집니다. 100개가 쌓이면 강의 준비 방식이 달라집니다. 1,000개가 쌓이면 우리 커뮤니티만의 AI 강의 지식베이스가 됩니다.

마크다운은 작고 조용한 기술입니다. 하지만 이 작은 문법이 우리의 강의 경험을 정리하고, 동료의 시행착오를 연결하고, 공개 가능한 지식 자산으로 확장하는 날개가 됩니다.

다음 장에서는 이 마크다운 작업을 더 편하게 만들어줄 필수 플러그인만 골라, 초보자도 부담 없이 사용할 수 있는 옵시디언 작업 환경을 완성해보겠습니다.

참고

1Obsidian 공식 소개

2Publishing Obsidian.md notes with GitLab Pages

3Obsidian Markdown Cheatsheet: Every Syntax You Actually Need

4Obsidian Prompts Store

5My Quartz + Obsidian Note Publishing Setup

책 목록

비전공자도 바로 시작하는 옵시디언 × 깃허브 지식 운영 백서

전체 목차 보기

이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.

틸노트는 사용자가 AI를 활용해 노트를 쉽게 작성하거나 편집할 수 있는 서비스입니다.

AI 스퀘어 단톡방에 함께해요

AI 활용과 틸노트 사용 팁을 나누는 오픈채팅방입니다. 입장 비밀번호는 tilnote입니다.

참여하기