Moving Wordpress to Jekyll


Why migrate?

I just wanted to learn a new tool and improving the design of the site.


Almost 3 years this site was powered using WordPress. Since the beginning of the year, I was thinking about how to convert this blog for a static site generator tool.

I had 2 options


DocPad is a framework that allowing for content management via the file system, this tool offer support to plugins that are used for rendering, and has static site generation. It's built with Node.js and Express.js.


Jekyll-bootstrap is very simple, has a minimal structure for blogs, and a static site generator. I chose this one.

New version

Their version isn't a dependency on server-side, it's just server delivery static files. Other services that I use are Google Analytics (for statistics about users), Disqus (for comments), GitHub (version control).

biggest problems for migration

  • Keep the previous content
  • Keep the same URLs
  • Keep path of Images
  • Comments
  • Convert content for english

Keep the previous content

I migrate all posts from Wordpress, using WordPress to Jekyll exporter. This tool is a WordPress plugin that converts all posts, pages, taxonomies, metadata, and settings to Markdown and YAML which can be dropped into Jekyll. Thanks Ben Balter for this nice job.

Keep the same URLs

I think about a simple navigation tree, with support for multiple languages, which in the end is like this:

  • Home
  • Blog

    • Posts (english and portuguese, on the same page)
  • Talks (english and portugues, on the same page)
  • About


I wanted to keep current comments from Disqus, for this a will to continue using this tool. Jekyll-bootstrap has this feature.


More simplicity for changes in code, more simplicity for users to read my blog, and the site load faster. This is due to in the fact all my posts are static assets now. Now I write the posts using Markdown + HTML.


made by me with 🖤 since 2007