프론트매터
title과 description은 모든 노트에 필수입니다. description은 검색 결과와 링크 호버 미리보기, OG 이미지에 그대로 쓰이므로 한 문장으로 내용을 말해야 합니다.
---
title: 노트 제목
description: 한 문장 요약
tags:
- concept
aliases:
- 다른 이름
---| 키 | 필수 | 용도 |
|---|---|---|
title | ✅ | 페이지 제목. 파일명과 달라도 됩니다 |
description | ✅ | 요약. 검색·호버·OG 이미지에 노출 |
tags | 권장 | 분류. 태그 페이지가 자동 생성됩니다 |
aliases | 선택 | 다른 이름으로도 링크·검색되게 함 |
draft | 선택 | true면 빌드에서 제외 (비공개 초안) |
date | 선택 | 없으면 git 커밋 시각을 씁니다 |
draft: true는 게시만 막습니다. 비밀은 여기 두지 마세요 — 히스토리에는 남습니다. 진짜 비공개는 private/ 폴더에 두면 빌드에서 아예 제외됩니다.
파일명
- 소문자 + 하이픈:
chain-of-thought.md - 논문은
저자연도-제목:vaswani2017-attention-is-all-you-need.md - 한글 파일명은 피하고 제목만 한글로 씁니다. URL이 퍼센트 인코딩되어 지저분해집니다.
대소문자 주의
개발 환경(Windows/WSL)의 파일시스템은 대소문자를 구분하지 않지만 배포 빌드는 Linux에서 돌아 구분합니다. 로컬에서 멀쩡하던
[[Transformer]]링크가 실제 파일이transformer.md면 배포 후에만 깨집니다. 파일명과 링크를 항상 소문자로 통일하면 이 문제가 사라집니다.
링크
- 노트끼리는 마크다운 링크가 아니라 위키링크
[[transformer]]를 씁니다. 백링크와 그래프뷰가 이걸로 만들어집니다. - 표시 텍스트가 필요하면
[[transformer|트랜스포머]]. - 링크 해석은
shortest모드라 파일명이 위키 전체에서 유일하면 경로 없이[[transformer]]로 충분합니다. 이름이 겹치면 빌드가 경고를 냅니다 — 그때 경로를 붙이세요. - 아직 없는 노트도 미리 링크해 둡니다. 그래프뷰의 빈 노드가 곧 할 일 목록입니다.
태그
폴더가 이미 대분류이므로 태그는 폴더와 직교하는 축에만 씁니다.
- 상태:
#seed(메모 수준) →#growing(정리 중) →#evergreen(안정) - 성격:
#moc,#meta - 횡단 주제:
#efficiency,#alignment,#multimodal
#llm 처럼 위키 전체에 해당하는 태그는 정보량이 0이므로 쓰지 않습니다.
노트 크기
한 노트는 한 가지를 다룹니다. 제목을 한 문장으로 요약할 수 없다면 쪼갤 때입니다. 위키의 가치는 노트 길이가 아니라 링크 밀도에서 나옵니다.