# Ledger → Beancount 변환기

Ledger 또는 hledger 저널을 붙여넣기만 하면 실행 가능한 Beancount를 얻을 수 있습니다. 두 형식은 매우 유사하여 수동 변환 시 위험이 따릅니다. 따라서 매핑할 수 없는 항목은 조용히 삭제되지 않고 줄 번호와 함께 보고됩니다.

모든 작업은 브라우저 내에서 실행됩니다. 저널이 서버에 업로드되지 않습니다.

[변환기 열기](https://beancount.io/ko/tools/ledger-to-beancount#converter)

## Beancount 출력

저널을 붙여넣으면 변환된 결과가 여기에 표시됩니다.

## 이 도구에 관한 질문

**저널이 서버에 업로드되나요?**

아니요. 변환은 이 페이지의 JavaScript를 통해 브라우저 내에서만 실행됩니다. 저널이 beancount.io나 다른 곳으로 전송되지 않으며, 저장되지도 않습니다. 인터넷 연결을 끊고 변환해도 정상 작동하므로 확인할 수 있습니다.

**Ledger와 Beancount의 실제 차이점은 무엇인가요?**

실제로 세 가지 차이가 있습니다. 계정 이름: Ledger는 공백과 소문자를 허용하지만, Beancount는 다섯 가지 루트 중 하나로 시작하고 대문자, 공백 없는 세그먼트를 요구합니다. 따라서 'expenses:home:rent'는 'Expenses:Home:Rent'가 됩니다. 금액: Beancount는 항상 숫자를 먼저 쓰고 통화를 뒤에 씁니다. 따라서 '$84.23'은 '84.23 USD'가 됩니다. 또한 Beancount에서는 계정을 사용 전에 반드시 열어야 하는데, Ledger는 그렇지 않습니다. 이 도구는 이 모든 것을 처리하며, 이름이 변경된 모든 계정을 알려줍니다.

**변환할 수 없는 것은 무엇인가요?**

괄호나 대괄호 안의 가상 분개는 Beancount에 해당하는 것이 없습니다. Beancount는 모든 거래가 균형을 이루어야 하기 때문입니다. 자동 거래('=')와 정기 거래('\~')도 마찬가지입니다. 포함된 파일은 먼저 인라인 처리되어야 합니다. 변환기는 붙여넣은 내용만 보기 때문입니다. 이러한 항목들은 출력에서 주석 처리되고 줄 번호와 함께 나열되므로 조용히 사라지지 않습니다.

**결과가 올바른지 어떻게 확인하나요?**

출력에 대해 bean-check를 실행하세요. 'uvx --from beancount bean-check main.bean' 명령어는 영구 설치 없이 작동합니다. 불균형 거래, 열리지 않은 계정, 구문 오류를 잡아냅니다. 그런 다음 Ledger의 잔액 보고서와 비교하세요. 합계가 일치하면 변환이 올바르게 수행된 것입니다.

## 파일을 변환했습니다. 이제 영원히 보관하세요.

Beancount.io는 은행 연동, 보고서, 모바일 앱과 함께 일반 텍스트 원장을 호스팅합니다. 파일은 언제든지 다운로드할 수 있습니다.

[무료로 시작하기→](https://beancount.io/sign-up/?next=%2Fledger%2F) [Beancount와 hledger 비교](https://beancount.io/ko/compare/beancount-vs-hledger)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
