AI 도구를 쓰다 보면 .md 파일이 계속 등장합니다. CLAUDE.md, README.md, SKILL.md, AGENTS.md. 확장자 md는 Markdown(마크다운)의 약자로, 메모장에 적듯 쓰면서도 제목·목록·표를 표현할 수 있는 아주 단순한 문서 형식입니다. 워드 파일처럼 프로그램이 필요 없고, 어떤 편집기에서든 그대로 읽힙니다.

기본 문법 한 장 정리

실제 예시 하나를 보겠습니다.

# 우리 병원 홈페이지 운영 규칙

## 절대 지킬 것
- 원장 약력은 **질문지 기준**으로만 쓴다
- 이미지 파일명은 영문으로

## 자주 하는 일
1. 건강칼럼 발행
2. 팝업 교체

참고: [게시판 안내](https://oncelink.ai/community/ol-guide)

프론트매터: 문서 맨 위의 이름표

파일 첫머리를 ---로 감싸고 그 안에 키: 값을 적으면, 문서에 대한 정보(제목, 태그, 날짜)를 붙일 수 있습니다. 본문에는 표시되지 않고 도구가 읽는 부분입니다. 옵시디언은 이를 "속성(properties)"이라 부르고, Claude Code의 스킬 파일도 같은 방식으로 이름과 설명을 적습니다.

---
tags: [worklog, tenant]
date: 2026-09-08
---
# 작업 기록: 팝업 교체

옵시디언 위키링크

옵시디언(Obsidian)은 md 파일 폴더를 "노트 묶음(볼트)"으로 다루는 앱입니다. 여기서는 [[문서 이름]]처럼 대괄호 두 겹으로 다른 문서를 연결합니다. 주소를 몰라도 파일 이름만 적으면 링크가 되고, 어떤 문서가 서로 이어져 있는지 그래프로 보여 줍니다. 저희는 병원별 문서와 작업 기록을 이 방식으로 연결해, "이 병원에 지난달 무엇을 했지"를 링크 몇 번으로 따라갑니다.

왜 AI 도구는 md를 지식의 정본으로 쓰나

• AI가 그대로 읽는다: 워드나 PDF는 변환이 필요하지만 md는 텍스트 그 자체라서 손실 없이 읽힙니다. 제목 구조도 함께 전달됩니다.
• 사람도 읽는다: 편집 프로그램 없이 열리고, 서식이 단순해 누구나 고칠 수 있습니다.
• 변경 이력이 남는다: 깃(Git) 같은 도구가 줄 단위로 "무엇이 바뀌었는지"를 보여 줍니다.
• 기억이 내 손 안에 있다: 채팅 기록은 앱 안에 갇히지만, md 파일은 작업 폴더 옆에 남아 다음 세션, 다른 도구, 다른 사람에게 그대로 넘어갑니다.

관례로 굳어진 md 파일들

원장님이 오늘 해 볼 것

메모장을 열어 병원 홈페이지 운영 규칙 다섯 줄을 md로 적고, 파일 이름을 CLAUDE.md로 저장해 작업 폴더에 두십시오. 그 순간부터 AI는 매번 그 규칙을 읽고 시작합니다. 지시를 채팅에 반복하는 대신, 파일 한 장을 고쳐 나가는 쪽이 훨씬 덜 지칩니다.

참고 링크

• CommonMark 마크다운 기본 문법 요약
• GitHub Flavored Markdown 사양(표·체크박스 확장)
• 옵시디언 도움말: 내부 링크(위키링크)
• 옵시디언 도움말: 속성(프론트매터)
• Claude Code 공식 문서: CLAUDE.md와 자동 메모리
• AGENTS.md 소개