dayone2md

I recently started journaling with Dayone but wanted a way to backup and view my entries outside of the app. So I created dayone2md, a CLI app to export Dayone to markdown.

dayone2md works with the desktop version of Dayone, which is available only for MacOS. Use an export (JSON) from Dayone or have dayone2md read directly from the Dayone database.

Repository

https://github.com/kwo/dayone2md

Installation

brew install kwo/tools/dayone2md

Features

• Input sources:
  • JSON export archive
  • read directly from the Dayone database
• Wikilinks: rewrite links to other entries as wikilinks
• Photos: download embedded photos and rewrite photo links
• Templates: supports external templates
• Title: separate out first line of posts as a title to format as desired
• In-place updates to output folder
• Conditional updates: only write files to output folder that differ from source
• Option to keep files in the output folder that do not exist at the source
• Flag to group posts by day in a single file
• Flag to alter sort order within day when grouped by day
• Installation: static binary without dependencies on external libraries

Example Usage

Create a directory of markdown files after creating a JSON export from the Dayone app:

dayone2md -i "$HOME/Desktop/09-07-2023_8-30-PM.zip" -o $HOME/Documents/Journal -j Journal -g -vv

Export entries directly from the Dayone database:

dayone2md -i "$HOME/Library/Group Containers/5U8NS4GX82.dayoneapp2/Data/Documents/DayOne.sqlite" -o $HOME/Documents/Journal -j Journal -g -vv

Enjoy!