refboard/GDD
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하나
GDD 작업 공간은 폴더·문서 트리, Markdown 편집기와 미리보기, 우측 패널의 3분할 구조다. 폴더는 하위 문서를 묶고 문서는 실제 본문을 가진다. 부모·자식 구조와 정렬은 데이터베이스에 저장된다.
2. 첫 폴더와 문서 만들기
- 프로젝트를 연다.
- 좌측 문서 트리 머리글의
+를 눌러 루트 폴더를 만든다. - 생성된 폴더를 우클릭하고 + 새 문서를 고른다.
- 제목 입력란과 본문 편집기에 내용을 작성한다.
새 폴더의 기본 이름은 “새 폴더”, 새 문서의 기본 제목은 “제목 없음”이다. 우클릭 메뉴의 이름 바꾸기로 바로 정리한다.
3. 트리 정리
- 폴더의 화살표로 자식 문서를 접고 펼친다.
- 노드를 우클릭하면 새 폴더, 새 문서, 이름 바꾸기, 삭제 메뉴가 열린다.
- 문서나 폴더를 다른 폴더로 드래그해 부모를 바꾼다.
- 자기 자손 아래로 이동해 순환 구조가 되면 앱이 경고하고 이동을 막는다.
- 폴더를 삭제하면 확인 문구대로 자손도 함께 사라지므로 범위를 먼저 펼쳐 본다.
폴더를 선택하면 중앙에는 그 폴더의 자식 인덱스가 나타난다. 문서를 선택하면 편집기로 바뀐다.
4. 작성과 미리보기
데스크톱에서는 제목과 Markdown 본문을 왼쪽에서 편집하고 오른쪽에서 GFM 미리보기를 동시에 본다. 입력은 500ms 디바운스 뒤 자동 저장되므로 별도 저장 버튼이 없다. 표, 목록, 링크 등 GitHub Flavored Markdown 문법을 사용할 수 있다.
모바일에서는 문서를 처음 열 때 보기 모드가 기본이다. 상단 편집을 눌러 입력하고 보기로 돌아가 렌더링을 확인한다.
5. 3분할 레이아웃
데스크톱에서 두 개의 세로 구분선을 드래그하면 문서 트리와 우측 패널 너비가 바뀐다. 크기는 브라우저 localStorage에 저장되어 다음 방문에 복원된다. 우측 챗·블록·백링크 패널의 내용은 아직 자리 표시자이므로 현재 GDD 작성에는 중앙 편집 영역을 사용한다.
5.1. 팁과 주의
- 긴 기획서는 시스템별 폴더를 먼저 만들고, 한 문서에 한 의사결정 단위를 두면 트리가 읽기 쉽다.
- 자동 저장에는 짧은 지연이 있다. 문장을 입력하자마자 탭을 닫지 말고 잠시 기다린다.
- 기존 Markdown 묶음이 있다면 수동 복사보다 임포트 CLI가 폴더 구조를 보존한다.