Skip to content

CCampanini/keep-to-markdown

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 

Repository files navigation

keep-to-markdown

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

Requirements

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

About

Convert Google keep notes to markdown notes

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%