erikelisath / keep-to-markdown

Convert Google keep notes to markdown notes

keep-to-markdown

A script to convert Google Keep notes into markdown files, for Linux, Mac, and Windows.

Requirements

• Python 3.x
• Google Takeout notes as Json (See How to download your Google data)

Example

> python keep-to-markdown.py -i Takeout/Keep/

arguments:
  -i PATH       Relative path to the Google Keep data folder

optional arguments:
  -h, --help    Show this help message and exit
  -t            Use subfolders for tags instead of YAML front-matter

The script outputs to a notes directory. Images will be stored in notes/resources.

If the -t flag is included, the first tag (if present) of each note will be used to create a subfolder. (e.g. notes/code_snippets and notes/code_snippets/resources)

Other data is extracted and written as YAML front-matter:

• title
• tags (if the -t flag isn't specified)
• text content
• task list
• web links
• images

Example

Example of a converted markdown note:

---
title: <Title>
date: <Date> (optional, if title is set)
tags: <tag1>;<tag2>;
---

<textContent>
Example Text ...

<listContent>
*Tasklist*:
- [ ] task1
- [x] task2

<annotations>
*Weblinks:* [link1](http//..); [link2](http://..);

<attachments>
*Attachments:* ![image](resource/image.jpg)

A note's title will be used for its filename. If there is no title available the created timestamp will be used.

Future features

• OS compatible
• support folder tags for Nextcloud
• save modified Timestamp by default
• use Google keep colors
• usability for Joplin import