Docs
hledger has lots of docs, covering different needs.
They are listed below, and also in the site’s sidebar.
(But don’t worry - you don’t need to read all of them.)
You can read some of them offline too, using hledger’s help command or --help flag.
Getting started
-
hledger by example is a book introducing hledger gradually, through examples.
-
At the command line, you can see brief examples by running
hledger --tldr,hledger balance --tldr, etc (or in newer versions,hledger --examples,hledger balance --examples).
If you install a tldr viewer you’ll get better output. Or, view them online:
hledger, hledger add, hledger accounts, hledger add, hledger aregister, hledger balance, hledger balancesheet, hledger import, hledger incomestatement, hledger print, hledger-ui, hledger-web
Or here are some beginner friendly tutorials, showing four ways of working with hledger:
And some general tips:
Or if you’re comfortable with the command line, you could try these:
- A quick example (on the home page)
- 2 minute quick start
- 5 minute quick start
- 10 minute quick start
- hledger manual: Common tasks
- hledger manual: Journal cheatsheet
- Workflows
- hledger and Ledger (if you know Ledger)
- hledger and Beancount (if you know Beancount)
Or, here are some notable blog posts/articles to read:
- Sumner Evans: Plain Text Accounting is Pretty Cool
- Amitai Burstein: Why We Chose Plain Text Accounting with Hledger
- Teo Si-Yan: Making sense of your finances with hledger reports
- Matt Maguire: Plain Text Accounting with Emacs - part 2 - part 3
Reference
The manuals are the authoritative hledger docs.
- hledger manual (The big one! For an overview, go there, then look in the sidebar.)
- hledger-ui manual
- hledger-web manual
You can also read these offline, using commands like:hledger help,
hledger help -l,
hledger help -l print,
hledger help print,
hledger print -h
Some other useful reference docs:
Videos
Short videos:
- Coder Kaylee: Hledger in 10 Minutes: The Ultimate CLI Tool (2025, 5m)
- hledger fan: beginner lessons (2019-2021, ~3m)
- The Basics: An hledger Transaction
- hledger Basics: 3 Must-Know Options for the Balance Command
- The Basics: The hledger Register Command
- hledger Basics: Focus on Months
- hledger basics: save keystrokes!
- hledger: looking under the hood
- hledger: untie your data with “nots”
- hledger: fun and profit with incomestatement
- hledger: fast fancy formatting
- hledger: who did you pay?
- hledger: bring order to your expenses
- hledger: commands to help with reconciling7
- hledger: shortcuts part 1
- hledger: shortcuts part 2
- hledger: shortcuts part 3
- hledger add
- hledger iadd
- nontproject intros
- You Need to Know Double-Entry Bookkeeping for Personal Finance, part 1 (2026, 8m, in bangla)
- You Need to Learn hledger for Personal Finance: Beginners Guide, part 2 (2026, 20m, in bangla)
- Generate hledger Reports Like a Pro: Beginners Guide, part 3 (2026, 15m, in bangla)
- TORGiren DevOpses: hledger part 1 (2026, 10m, in polish)
Longer talks:
- O Clementino: Faça o Emacs olhar para o dinheiro usando o Embark (2026, 16m, in brazilian portuguese)
- O Clementino: Gerencie suas finanças como um hacker (2026, 23m, in brazilian portuguese)
- Youngbin Han @ FOSS for All
(2025, slides, in korean and english)
Plain Text Accounting with hledger
with short videos of add and web - Glenn Ramsey @ Kiwi Pycon XI (2022, 30m)
Plain text accounting for fun and profit - Simon Michael @ HaskellerZ meetup (2021, 2h)
Inside hledger: an architectural tour and how-to, slides - Conversations in Code, Episode 3: Introduction to Plain Text Accounting (2020, 1h, audio only), discussion
- Intproject Mi: Учет сделок с проводками в текстовом формате (2019, 34m)
- Evolution of hledger (Gource visualization) (2019, 38m)
- Simon Michael @ Brainium meetup (2016, 2h)
Hands-on with hledger - Chris Vollick @ DevHouse Waterloo meetup (2016, 40m)
hledger, an open source accounting tool - FLOSS Weekly episode 375: hledger (2016) - overview (3m), full interview (1h)
See also:
- Youtube: latest “hledger” videos (beware, there’s a ton of AI slop videos - report them if bad)
- PTA: Videos
Cookbook
Other docs, tips, and notes, are collected here.
USING HLEDGER
Checking for errors
Customising
Data entry
- Create a journal
- Getting prices
- How to record journal entries
- How to figure out journal entries
- Importing CSV data
- Cost notation
Examples
- examples/ - examples and snippets, old and new
- examples/csv/ - hledger CSV rules library
Making charts
Other software
- Exporting from hledger
- hledger and Beancount
- hledger and dsq / DataStation
- hledger and just
- hledger and GnuCash
- hledger and Ledger
- hledger and Obsidian
- hledger and Paisa
- hledger and Postgres
- hledger and Quicken/Quickbooks
- hledger and SimpleFIN
- hledger and SQLite
- hledger and Ultorg
- hledger and YNAB
Preserving your data
- Track changes with version control
- Backups, the 3-2-1 rule
Reporting
- Making sense of your finances with hledger reports
- Report examples
- Reporting version control stats
- Rewrite account names
- Rewrite commodity symbols
- Tags tutorial
Scripts and add-ons
Setups and workflows
User interfaces
ACCOUNTING
Accounting and bookkeeping
- Accounting basics for PTA users
- Accounting: further study
- Common journal entries
- PTA: Choosing cash or accrual
Borrowing and lending
Budgeting
Eco accounting
Forecasting
FOSS projects
Inventory tracking
Investing and trading
- PTA Cookbook: Investing and trading
- hledger manual: Cost reporting
- hledger manual: Value reporting
- hledger manual: balance features
- Track investments (2017)
- Track investments (2020)
- Calculate unrealized gain
- Calculate return on investment
- hledger-lots
- Average cost capital gains with hledger 2023
- Track foreign stock capital gains using hledger 2023
- Full-fledged hledger: Manual lot tracking 2024
Invoicing
Multiple currencies
- Multicurrency tutorial (2018)
- Currency conversion (2021)
- hledger manual: Cost reporting
- hledger manual: Value reporting
Non-profit accounting
Taxes
Time tracking
Trip expenses
Shared expenses
See also…
If you still haven’t found what you’re looking for, try these: