핵심 흐름
content/아래에.md파일을 만든다.- frontmatter(상단 메타데이터)를 채운다.
- 본문을 마크다운으로 쓴다.
git add→git commit→git push- 잠시 후 Vercel이 자동 배포한다.
파일 위치 = 카테고리
content/
├── index.md ← 홈페이지
├── about.md ← /about
├── dev/ ← 개발 카테고리
│ ├── git-basics.md
│ └── markdown-cheatsheet.md
└── welcome/ ← 사이트 소개
└── hello-notes.md
폴더 이름이 URL 경로의 일부가 된다. 예: content/dev/git-basics.md → /dev/git-basics.
좌측 Explorer 사이드바가 이 폴더 구조를 트리로 보여준다.
frontmatter 템플릿
---
title: 글 제목
description: 한 줄 요약 (목록/SEO에 사용됨).
created: 2026-05-20
tags:
- 태그1
- 태그2
draft: false
---필드 설명
- title: 글 제목. 생략하면 파일명이 자동 사용됨.
- description: 글 한 줄 요약. 미리보기와 검색에 노출됨.
- created: 작성일 (YYYY-MM-DD).
- modified: 수정일 (선택).
- tags: 검색/분류용. 일관된 태그명을 쓰면 효과적.
- draft:
true면 배포 시 제외됨. - aliases: 같은 노트의 다른 URL 별칭 (선택).
노트끼리 연결하기 (위키링크)
Quartz는 Obsidian 스타일 위키링크를 지원한다.
[[git-basics]] → 같은 이름 노트로 링크
[[git-basics|Git 기본]] → 보여줄 텍스트 지정
[[dev/git-basics#커밋하기|커밋하기]] → 특정 제목으로 링크
![[이미지파일.png]] → 이미지 임베드링크된 노트의 하단에 자동으로 백링크가 표시된다. 노트끼리 연결할수록 사이트가 풍성해진다.
로컬에서 미리 보기
npx quartz build --serve
# → http://localhost:8080 에서 확인저장하면 자동으로 새로고침된다.
자주 하는 실수
created형식이 틀리면 빌드 실패.YYYY-MM-DD형식 지키기.- 파일명에 공백 쓰지 말기 (URL이 이상해진다). 영문 소문자 + 하이픈 추천.
- 이미지는
content/아래 어디든 두고 상대경로로 참조. draft: true채로 push하면 사이트에 안 나옴 (의도한 게 아니라면 false 확인).
끝
이 사이트의 본질은 “마크다운 한 장 = 노트 한 개”. 그 규칙만 지키면 된다.