Skip to content
Andreas Pauley edited this page Apr 6, 2019 · 92 revisions

Welcome to the hledger Cookbook! This complements the main hledger website and reference docs with additional how-tos, tutorials, notes, etc. Unlike the main content, it is stored in hledger's Github wiki. This means you can make quick edits via Github's web UI, without pull requests or tool setup. Please edit freely!

Editing tips:

  • Use the links below to organise Cookbook content. They (everything from the "Cookbook" heading down) will automatically appear on the home page.
  • Github wikis help
  • editing requires a github account
  • edit by web, or by git clone, local edit, git push
  • link between wiki pages: [[Pagename]] or [[Other text|Pagename]]. Pagename is case insensitive and can have spaces.
  • link to wiki pages from elsewhere: Pagename is case insensitive and can have spaces.
  • link to hledger manual sections from the wiki: anchor is any manual heading's text, lowercased with punctuation removed and spaces replaced by hyphens.
  • when renaming a page, try also to update the links to it
  • For the most accurate rendering, live updating etc., you may prefer to render the hledger website and cookbook locally, with live updating, etc. In your copy of the hledger repo, clone the wiki to ./wiki and try make help-site, make site-liverender, make site-livereload, ./Shake help etc.


Getting started

hledger basics tutorial
hledger terminology
Create a journal
hledger accounting concepts
Common journal entries
Accounting links

Managing data

Convert CSV files
Customize default CSV accounts
Track changes with version control
Use another account separator character


hledger tags tutorial
Rewrite account names

Real world setups

About real world setup docs
"Full-fledged Hledger" tutorial →
"Hledger Flow" tutorial & slideshow →
Simons setup

Accounting tasks

hledger multicurrency tutorial
Foreign trip expenses
Budgeting and forecasting
Project accounting
Track investments
Time planning

Usage tips

Command-line completion
Editor configuration
hledger-web tips
Mobile apps
Save frequently used options

See also... (software, docs, common tasks, discussion)  →
Ledger (docs, wiki)  →
Beancount (docs)  →

You can’t perform that action at this time.