A simple tool written in Ruby that converts exported Delicious bookmarks from HTML to JSON.
Clone or download
Latest commit 304372d Dec 2, 2014
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Initial commit. Nov 19, 2014
.gitignore Initial commit. Nov 19, 2014
Gemfile Initial commit. Nov 19, 2014
Gemfile.lock Initial commit. Nov 19, 2014
README.md Minor README update. Dec 1, 2014
Rakefile Sort all the things (links by date, keys alpha, tags alpha) Nov 24, 2014


Delicious Data Convertor

A simple Ruby-based tool for converting an exported delicious.html file from Delicious into JSON.


  • No aversion to the command line
  • Ruby (2.1.4)
  • Bundler (1.7.4 or newer)
  • A Delicious account


  1. Install Ruby 2.1.4. If you're using Mac OS X, you can use tools like chruby, rbenv, or RVM to install multiple versions of Ruby, including the one required for this tool.
  2. Install Bundler (gem install bundler).
  3. Install gems (bundle install).


  1. Clone this repository and cd into the delicious-data-convertor directory.
  2. Visit the "Manage" section of your Delicious account and choose "Export Bookmarks." Be sure to include tags and notes in the export (the default).
  3. Save the resulting delicious.html file to this project's data directory.
  4. Back over in Terminal, run rake convert from the root of the project.
  5. Marvel at the resulting delicious.json file in the data folder!


I slapped this together quickly in an hour or so. It's really only tested against an export of my Delicious bookmarks. It may or may not work for you.

HTML elements in titles and descriptions

I encountered an issue with bookmarks that had strings like <article>, <url>, etc. in titles and descriptions. Basically, instances where there were HTML elements (or strings that look like HTML elements) caused Nokogiri to go haywire. I couldn't find a bulletproof solution to this, so I manually changed < to &lt; and > to &gt; in titles and descriptions.

For example, this:

A sample description referencing an <html> element.

became this:

A sample description referencing an &lt;html&gt; element.

It's not perfect, but it's the best I could figure out in a timely fashion.


Per CC0, to the extent possible under law, I have waived all copyright and related or neighboring rights to this work. Go forth and make things.