Black Lives Matter. Support the Equal Justice Initiative and read our statement here.
Geeks Diary

Geeks Diary

TIL writing tool for programmer

Geek's Diary

Build Status

Geek's Diary is markdown editor with version control system integrated. It helps programmers to write TIL(Today I Learned).

Main Screenshot

🚀 Beta releases

You can download the installer from Github Releases.

Currently, only macOS is supported. The official version (v1.0.0) will also support Windows.

AutoUpdater is omitted from beta release. When a new version is released, you will need to update it manually.


Mix markdown with code


A note in Geek's Diary is comprised of snippets (markdown, code). You can freely mix different snippet types within one note.

Categorize your note with development stack


Geek's Diary is for programmers. You can categorize your note with numerous development stacks (from konpa/devicon).

Contribute measurement


Geek's Diary measures contribution with commit counts in a day. You can look your contribution level with grass UI in calendar. Similar with github!

Version Control System integrated


Control your version with powerful VCS -- We currently supports git. Geek's Diary tracks your file changes from workspace, and you can committed it.

Sync with remote repository


Thanks to the integration of the version control system, you can sync your workspace with remote repository. Log in to github and sync your TILs.


These are v1.0.0 features.

  • Auto Updater #124
  • Release win32 platform
  • Performance issue for note editor #113
  • Migrate from existing TIL repository #120



Project setup

Fork the project on GitHub and clone your fork locally.

git clone
cd geeks-diary

git remote add upstream
git fetch upstream

yarn install


yarn serve:browser:app
yarn serve:browser:wizard
yarn serve:main-process

// After build completed.

yarn start


yarn test


❤️ Thanks for your interest!

If you have suggestions for how this project could be improved, or want to report a bug, open an issue! We'd love all and any contributions. If you have questions, too, we'd love to hear them.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


MIT Licensed

Main Screenshot Main Screenshot
Commit Note Commit Note
Sync with remote repository Sync with remote repository
Contribute Measurement Contribute Measurement

Something missing? Edit this app.

Keyboard Shortcuts

Key Action
/ Focus the search bar
Esc Focus the search bar and cleans it
Select the next search result
Select the previous search result
Enter Open the selected search result
cmdEnter Ctrl+Enter Open the selected search result in a new tab