Parse your Kindle clippings to create a book collection in Jekyll

1 minute read

Do you know every time you highlight something in your Kindle it’s stored in a file called MyClippings.txt? The file itself it’s ugly but it can be parsed to show something more eye-catching. Check the books collection I have.

Parse from txt to Markdown

I created a Nodejs app called Highlights to Markdown that parses this file and creates a Markdown file for each book, grouping the quotes. I know there are plenty of tools ( and scripts (1,2) doing similar things, but none of them fit my requirements and well I was bored in a rainy quaratined weekend :sweat_smile:.

Get and show the cover of the book

At the beginning, the way I showed the books was just a list of titles. Since now I have the latest Minimal Mistakes version, I used the grid collection layout with reverse order functionality to order the list in a more attractive way. To show the book covers, I used the API to query for them. They are automatically queries in Highlights to Markdown parser but you can manually add the link to the image if the script does not find it.

Use it with Jekyll

The markdown generated is intended to be used with a Jekyll collection. I have created a book collection the following way:

  1. Create a _books folder and move there all the generated files.
  2. Add the collection to your _config.yml:

      - _books
        output: true
        permalink: /:collection/:path/
      # _books
      - scope:
          path: ""
          type: books
          layout: single
          author_profile: true
          share: true
          comments: true
  3. Add a navigation link in the top bar editing navigation.yml inside _data folder:

      - title: Tu sueldo neto
      - title: CV
        url: /cv/
      - title: Books
        url: /books/
  4. Finally create a page that will have the links to all the books. I created and put it inside _pages folder:

    title: Books
    layout: collection
    permalink: /books/
    collection: books
    entries_layout: grid
    classes: wide
    sort_order: reverse

See an example

Check this blog repo to see the details on how to do it. Remember you need to parse the MyClippings.txt file as a first step.

Leave a comment