Wiki씨앗

이 위키 쓰는 법

위키 문서를 어떻게 쓰고 서로 어떻게 잇는지 정리한 문서. 첫 위키 문서라 자리 잡기용이기도 합니다.

마지막 갱신 작성

포스트와 위키를 나누는 기준

  • 포스트(content/posts/) — 내 통찰, 내 경험, 내가 겪고 생각한 것. 쓴 날짜가 의미를 가진다.
  • 위키(content/wiki/) — 정해진 정보 위주. 언제 썼는지보다 지금 내용이 맞는지가 중요하다.

frontmatter

---
title: 문서 제목
description: 한 줄 요약
aliases: [다른 이름, another name]   # 위키링크에서 이 문서를 부를 수 있는 이름
tags: [db]
created: 2026-07-01
updated: 2026-08-20
status: seed                        # seed | growing | evergreen (선택)
---

content/wiki/ 의 최상위 폴더명이 위키 목록의 분류가 된다. 이 문서는 meta/ 아래에 있어서 meta 로 묶인다.

문서 잇기

옵시디언 문법 그대로 쓴다.

쓰는 법결과
[[문서명]]그 문서로 가는 링크
[[문서명|보여줄 이름]]별칭 링크
[[문서명#헤딩]]문서 안 헤딩까지
[[#헤딩]]같은 문서 안 이동

문서명 자리에는 셋 중 아무거나 쓸 수 있고, 위에서부터 먼저 맞는 걸 고른다.

  1. 전체 경로 — [[meta/wiki-writing-guide]]
  2. 파일명 — [[wiki-writing-guide]]. 포스트처럼 폴더/index.mdx 구조면 폴더명이 파일명 역할을 한다
  3. title 또는 aliases[[위키 사용법]]

포스트와 위키는 서로 자유롭게 이을 수 있다. 예를 들어 위키에서 포스트로: origin-of-optimistic-locking, 적절한 JSON 형식 API 응답이 되려면.

링크를 걸면 가리켜진 쪽 문서 하단에 백링크가 자동으로 붙는다. 따로 관리할 필요가 없다.

아직 없는 문서로 링크를 걸면 빨간 점선으로 남고 빌드 로그에 경고가 뜬다. 앞으로 쓸 문서를 미리 걸어두는 표시로 쓰면 된다.