Day One to Obsidian Converter
MIT License
Convert your Day One journal entries into Markdown files compatible with Obsidian.
Before using dayone-to-obsidian
, ensure you have the following:
pip install dayone-to-obsidian
Follow these steps for conversion:
Prepare Your Day One Export: Export your Day One journal entries to a JSON file or directory containing multiple JSON files following the manual.
Run the Conversion: Open a terminal or command prompt and execute the CLI with the appropriate options. The command structure is as follows:
dayone-to-obsidian run --json /path/to/your/dayone_export.json --target /path/to/target_directory [--force] [--tag-prefix=prefix] [--tag=tag1] [--tag=tag2]
--json
: Path to your Day One export JSON file or directory.--target
: Path to the directory where converted Markdown files will be saved.--force
: Force the overwriting of existing journal folder.--tag-prefix
: Prefix for tags, allowing customization of how tags are formatted in the converted files.--tag
: Additional tag(s) to add to all entries. This option can be repeated to include multiple tags.--help
: Display the help message.Example command:
dayone-to-obsidian run --json ./DayOneExport/Journal.json --target ./ObsidianNotes --tag-prefix=DayOne/ --tag=Imported --tag=Journal
This command specifies a Day One JSON export file, sets the target directory for the converted Markdown files, adds a prefix to all tags, and includes additional tags for each entry.
Import to Obsidian: Once the conversion process is complete, manually move the generated Markdown files to your Obsidian vault directory.
If you encounter any issues or have suggestions for improvements, please open an issue in this GitHub repository.
This project is licensed under the MIT License. See the LICENSE file for details.