/highlights-to-markdown

Parse Kindle clippings and O'reilly highlights to Markdown files

Primary LanguageJavaScript

Kindle and O'Reilly highlights to Markdown

Introduction

This repo is a fork of highlights-to-markdown on Gitlab. Thanks Juan Pallarès!

Here is the CHANGELOG after forking.

Features

Node app to parse your Kindle (My Clippings.txt) or O'Reilly highlights and create a Markdown file per book grouping the quotes.

The quotes are grouped by Chapter (O'reilly) or Page (Kindle). The books have the date of the most recent quote assigned.

The script will attempt to get metadata from O'reilly Search API, fallback to openlibrary.org if failure.

Sample book generated from O'reilly: The Manager Path

How to install?

  1. Install Node if you haven't
  2. Clone and move to folder
  3. npm i
  4. Configure the output path $MARKDOWN_PATH

How to use for Kindle?

  1. Copy My Clippings.txt to this repo
  2. npm run kindle
  3. New files are generated at $MARKDOWN_PATH/highlights/kindle/

How to use for O'Reilly Highlights?

  1. Copy oreilly-annotations.csv to this repo
  2. npm run oreilly
  3. New files are generated at $MARKDOWN_PATH/highlights/oreilly/