Budget 가계부

역할

수입과 지출을 월별 마크다운 표로 기록하고, 대시보드에서 합계·카테고리별 지출·예산 소진·일별 추이를 보여 줍니다. 기록은 모두 보관소의 md 파일에 있고 플러그인 설정에는 거래 내역을 저장하지 않으므로, 플러그인을 지워도 데이터는 그대로 남습니다.

기록 파일

• 설정한 가계부 폴더에 월별로 지출 파일과 수입 파일을 따로 둡니다. 예: 2026-10_expense.md, 2026-10_income.md
• 폴더 설정이 비어 있으면 budget 폴더에 저장합니다.
• 폴더와 파일은 그 달의 첫 내역을 기록할 때 만듭니다.
• 파일 종류는 파일 이름이 아니라 속성으로 판단합니다. type이 expense 또는 income이고 month가 YYYY-MM 형식인 파일만 가계부 파일로 봅니다. 이름을 바꿔도 계속 인식합니다.
• 속성 이름, 표 머리행, type 값은 사용 언어와 관계없이 영어로 고정합니다. 카테고리 이름과 내역 내용은 입력한 그대로 적습니다.

---
type: expense
month: 2026-10
budget-total: 500000
budget-식비: 100000
---

# 2026-10 expense

| Date       | Item | Category | Amount  | Memo        |
| ---------- | ---- | -------- | ------- | ----------- |
| 2026-10-01 | 점심 | 식비     | 12,000  | 회사 근처   |
| 2026-10-03 | 셔츠 | 의류     | -38,000 | 사이즈 환불 |

표 읽기

• 파일의 첫 번째 표를 내역 표로 봅니다. 표 밖의 내용은 읽지도 고치지도 않습니다.
• 열은 머리행의 이름으로 찾으므로 순서가 달라도 됩니다. 모르는 열은 무시하되 다시 쓸 때 보존합니다.
• Date는 YYYY-MM-DD여야 하고 실제로 있는 날짜여야 합니다.
• Amount는 12000, 12,000, 12,000원, ₩12,000을 모두 받습니다. 음수와 소수도 받습니다.
• 환불은 수입 파일이 아니라 지출 파일에 음수 금액으로 적습니다.
• 읽지 못한 행은 버리지 않고 대시보드의 경고에 표시합니다.

표 쓰기

• 내역을 추가·수정·삭제하면 표 영역만 다시 씁니다.
• 새 행은 날짜가 더 늦은 첫 행 앞에 넣습니다. 같은 날짜끼리는 기존 순서를 지킵니다.
• 새로 넣거나 수정한 행의 금액은 천 단위 쉼표를 넣어 씁니다. 정수는 그대로, 소수는 둘째 자리까지 씁니다. 통화 기호는 파일에 쓰지 않습니다.
• 고치지 않은 행의 금액은 파일에 적힌 글자 그대로 둡니다. 직접 적은 12000원이나 소수 셋째 자리 이하도 바뀌지 않습니다.
• 열 폭을 맞춰 정렬합니다. 한글은 두 칸으로 셉니다. 구분선의 정렬 표시(:---, ---:, :---:)는 유지합니다.
• 파일의 줄바꿈이 CRLF이면 CRLF로 다시 씁니다.
• 셀 안의 |는 \|로 적습니다.
• 수정·삭제 직전에 파일을 다시 읽어 대상 행을 원문으로 대조합니다. 행을 찾지 못하거나 같은 행이 둘 이상이면 쓰지 않고 파일이 변경되었습니다. 새로고침 후 다시 시도하세요.를 알립니다.

예산 속성

• 예산은 달마다 따로 지정하며 그 달 지출 파일의 속성에 저장합니다.
• 카테고리마다 budget-카테고리이름 속성 하나를 숫자로 씁니다. 예: budget-식비: 100000
• budget-total은 카테고리와 별개로 잡는 한 달 전체 예산입니다. 없으면 카테고리 예산의 합을 전체 예산으로 씁니다.
• total은 전체 예산에 쓰는 이름이므로 카테고리 이름으로 쓸 수 없습니다.
• 속성 화면에서 숫자 속성으로 보이며 직접 고칠 수 있습니다.
• 예전 형식인 budget: 아래의 중첩 맵도 읽습니다. 예산을 다시 저장할 때 새 형식으로 바꿉니다.

내역 입력

• Budget: 지출 기록, Budget: 수입 기록 명령이나 대시보드의 + 버튼으로 입력 창을 엽니다.
• 입력 순서는 지출/수입 전환, 금액, 항목, 카테고리, 날짜, 메모입니다. 금액과 항목은 필수이고 날짜는 오늘이 기본값입니다.
• 모바일에서 금액 칸은 소수점이 있는 숫자 키패드를 엽니다.
• 카테고리는 자동완성을 제공합니다. 후보는 설정의 카테고리 목록에 이번 달과 지난달 파일에서 실제로 쓰인 카테고리를 더한 것입니다. 목록에 없는 이름을 입력해도 됩니다.
• 입력칸에서 Enter를 누르면 저장하고 닫습니다. 자동완성 목록이 열려 있을 때의 Enter는 후보만 고르고, 한글을 조합하는 중의 Enter는 저장하지 않습니다.
• 저장 후 계속은 저장한 뒤 창을 닫지 않고 날짜와 종류만 남긴 채 나머지를 비웁니다.
• 내역은 입력한 날짜가 속한 달의 파일에 적습니다.
• 저장이 끝나기 전에 다시 눌러도 한 번만 기록합니다.

수정과 삭제

• 대시보드의 내역 행을 클릭하면 같은 창이 수정 모드로 열립니다. 휴지통 아이콘으로 삭제하며, 삭제 전에 확인을 묻습니다.
• 날짜를 다른 달로 바꾸거나 지출/수입을 전환하면 원래 파일에서 먼저 빼고 새 파일에 넣습니다. 넣지 못하면 원래 파일에 되돌립니다.
• 다른 파일로 옮길 때 사용자가 표에 직접 추가한 열의 값은 대상 파일에 같은 이름의 열이 있으면 함께 옮깁니다.

대시보드

Budget: 대시보드 열기 명령이나 지갑 리본 아이콘으로 엽니다. 메인 영역에 새 탭으로 열리고, 이미 열려 있으면 그 탭으로 이동합니다. 본문은 넓은 탭에서도 780px에서 멈추고 가운데 정렬합니다.

위에서부터 다음 순서로 표시합니다.

1. 헤더
2. 경고
3. 요약
4. 카테고리별 지출과 수입
5. 일별 지출
6. 내역

가계부 폴더 안의 md 파일이 바뀌면 다시 읽어 그립니다. 폴더 밖의 노트가 바뀔 때는 다시 그리지 않습니다.

헤더

• 왼쪽에 ‹, 월 선택기, ›를 둡니다. 월 선택기의 달력 아이콘을 누르면 연·월을 골라 바로 이동하고, 이번 달로 돌아올 수 있습니다.
• 오른쪽에 기록(+), 예산 편집, 새로고침 버튼을 둡니다.
• +로 연 입력 창의 날짜는 이번 달을 보고 있으면 오늘, 다른 달이면 그 달 1일이 기본값입니다.
• 달을 바꾸면 카테고리 필터를 풉니다.

경고

해당하는 것이 있을 때만 표시합니다.

• 인식하지 못한 줄: 이유와 원문을 보여 줍니다. 누르면 원본 파일의 그 줄을 엽니다.
• 다른 달 날짜: 파일의 month와 다른 달의 날짜가 적힌 내역입니다. 누르면 원본 파일의 그 줄을 엽니다. 합계에는 포함하고 일별 차트에서는 뺍니다.
• 고정지출 미입력: 아직 기록하지 않은 고정지출의 이름을 보여 주고, 입력하기로 일괄 입력 창을 엽니다. 아직 오지 않은 달에는 표시하지 않습니다.

요약

• 수입, 지출, 잔액, 저축률 카드를 표시합니다. 잔액은 수입에서 지출을 뺀 값이고 저축률은 잔액을 수입으로 나눈 값입니다.
• 수입과 지출 카드에는 전월 대비 증감률을 붙입니다. 전월 값이 0이면 전월 없음을 표시합니다.
• 수입이 0인 달에도 저축률 카드를 남기고 값을 —로 둡니다.
• 수입이 있으면 수입 대비 지출 막대를 표시합니다.
• 전체 예산이 있으면 예산 대비 지출 막대를 223 / 500,000원 · 0.0% 형식으로 표시합니다.
• 두 막대 모두 100%를 넘으면 빨강으로 바뀝니다.

카테고리별 지출과 수입

• 카테고리마다 이름, 건수, 금액, 막대를 금액이 큰 순서로 표시합니다. 카테고리가 비어 있는 내역은 미분류로 묶습니다.
• 예산이 있는 카테고리는 12,000 / 100,000원과 예산 소진율을 표시하고, 예산을 넘으면 막대가 빨강으로 바뀝니다. 내역이 없어도 예산이 잡힌 카테고리는 표시합니다.
• 예산이 없는 카테고리는 금액과 전체에서 차지하는 비중을 표시합니다.
• 전월에 같은 카테고리가 있으면 증감률을 붙입니다.
• 행을 클릭하면 내역이 그 카테고리로 필터됩니다. 다시 클릭하면 풉니다. 지출과 수입에 같은 이름의 카테고리가 있어도 클릭한 쪽의 내역만 남깁니다.
• 수입 내역이 있으면 같은 형식으로 카테고리별 수입도 표시합니다.

카테고리 이름 바꾸기

• 카테고리 행을 우클릭하면 이름 바꾸기가 나옵니다. iOS에서는 길게 누릅니다. 미분류에는 나오지 않습니다.
• 같은 종류의 모든 달 파일에서 내역의 카테고리와 예산 속성을 함께 바꿉니다. 설정의 카테고리 목록도 바꾸고, 지출 카테고리면 고정지출의 카테고리도 바꿉니다.
• 이미 있는 카테고리 이름을 넣으면 두 카테고리가 합쳐지고 예산은 더해집니다.
• 지출 카테고리는 total로 바꿀 수 없습니다.

일별 지출

지출 내역이 있는 달에만 표시합니다. 막대와 누적을 전환하며 기본은 막대입니다. 두 계열을 한 그림에 겹치지 않습니다.

• 막대: 날짜별 지출입니다. 지출이 없는 날은 비워 두고, 환불로 순액이 음수인 날은 0선 아래로 그립니다. 아래에 최고액과 일평균을 표시합니다. 일평균은 막대에 그린 값으로 계산하므로 다른 달 날짜가 적힌 내역은 들어가지 않습니다.
• 누적: 1일부터의 누적 지출입니다. 이번 달은 오늘까지만 긋습니다.
  • 전체 예산이 있으면 월말에 예산을 꼭 맞게 쓰는 속도를 점선으로 겹쳐 그리고, 누적선이 그 위에 있으면 빨강으로 바꿉니다.
  • 아래에 누적액과 예산을 표시하고, 달이 끝나지 않았으면 지금 속도로 쓸 때의 월말 예상액을 함께 표시합니다.
• 어느 쪽이든 날짜 위에 마우스를 올리면 그날의 값이 나옵니다.

내역

• 수입과 지출을 한 표에 날짜, 항목, 카테고리, 금액으로 표시합니다. 메모는 항목 옆에 흐리게 붙입니다. 지출은 -, 수입은 +를 붙입니다.
• 전체 / 지출 / 수입 전환과 검색을 제공합니다. 검색은 항목, 카테고리, 메모에서 찾습니다.
• 날짜와 금액 머리를 누르면 그 열로 정렬하고, 다시 누르면 방향을 뒤집습니다.
• 행을 클릭하면 수정 창이 열리고, 우클릭하면 원본 파일의 그 줄을 엽니다. iOS에서는 길게 누릅니다.

상태 유지

보던 달, 전체 / 지출 / 수입 전환, 막대 / 누적 전환, 정렬은 워크스페이스에 저장해 Obsidian을 다시 열어도 유지합니다. 검색어와 카테고리 필터는 저장하지 않습니다.

예산 편집

• 대시보드 헤더의 예산 편집 버튼으로 엽니다. 보고 있는 달의 예산을 고칩니다.
• 맨 위에 전체, 그 아래에 카테고리별 입력칸이 나옵니다. 카테고리는 설정의 지출 카테고리, 그 달에 쓰인 카테고리, 이미 예산이 있는 카테고리를 합친 목록입니다.
• 맨 아래 입력칸에 이름을 넣고 추가를 누르면 목록에 없는 카테고리에도 예산을 잡을 수 있습니다.
• 비워 둔 칸은 예산을 잡지 않습니다. 음수는 저장하지 않고 알립니다.
• 그 달의 지출 파일이 없으면 저장할 때 만듭니다.

예산 이월

• 새 달의 지출 파일을 만들 때 직전 달에 예산이 있으면 그대로 가져올 수 있습니다. 전체 예산과 카테고리 예산을 모두 가져옵니다.
• 설정에 따라 물어보거나, 항상 가져오거나, 가져오지 않습니다. 기본은 물어보기입니다.
• 예산 편집에서 저장하다가 파일이 만들어질 때는 묻지 않습니다.

고정지출

• 월세나 구독처럼 매달 나가는 항목을 설정에 항목, 카테고리, 금액, 예정일로 등록합니다.
• 자동으로 기록하지 않습니다. 아직 나가지 않은 돈이 지출로 잡히면 월초 통계가 틀어지기 때문입니다.
• 그 달 지출 파일에 같은 항목 이름의 내역이 없으면 미입력으로 보고 대시보드 경고에 표시합니다. 이번 달과 지난 달에만 표시합니다.
• 경고의 입력하기나 Budget: 이번 달 고정지출 입력 명령으로 일괄 입력 창을 엽니다. 항목마다 체크, 날짜, 금액을 고칠 수 있고, 체크한 항목만 기록합니다.
• 날짜는 예정일이 기본값입니다. 예정일이 그 달의 말일보다 크면 말일로 맞춥니다.
• 전기·가스처럼 금액이 매달 다른 항목은 설정에서 금액을 비워 둡니다. 이런 항목은 체크가 해제된 채로 열리고, 금액을 넣어야 기록됩니다.

설정과 명령

설정 탭의 Budget 그룹에 다음 항목을 둡니다.

• 가계부 폴더: 비우면 budget입니다.
• 통화 기호 (앞)·(뒤): 화면에서 금액 앞뒤에 붙입니다. 한국어에서는 뒤에 원이 기본값이고, 그 밖의 언어에서는 기본값이 없습니다.
• 예산 이월: 물어보기, 항상 이월, 이월하지 않음 중에서 고릅니다.
• 지출 카테고리, 수입 카테고리: 한 줄에 하나씩 적습니다. 자동완성과 예산 편집에 쓰는 추천 목록이며, 목록에 없는 카테고리도 그대로 집계합니다.
• 고정지출: 항목, 카테고리, 금액, 예정일을 한 줄씩 등록합니다. 금액에 숫자가 아닌 값을 넣으면 알리고 이전 값으로 되돌립니다.

기본 카테고리는 한국어에서 다음과 같습니다.

• 지출: 식비, 카페·간식, 교통, 주거·공과금, 통신, 생필품, 의료, 문화·여가, 의류·미용, 경조사, 교육, 기타
• 수입: 급여, 부수입, 용돈, 이자·배당, 환급, 기타

명령은 다음 다섯 가지입니다.

• Budget: 대시보드 열기
• Budget: 지출 기록
• Budget: 수입 기록
• Budget: 이번 달 고정지출 입력
• Budget: 이번 달 지출부 열기: 이번 달 지출 파일을 엽니다. 없으면 만듭니다.

화면 문구는 플러그인 locales의 en/ko를 따릅니다. 파일에 적는 형식만 영어로 고정합니다.