Alex Pearwin

Escaping liquid tags in Jekyll

This post has been archived. It's pretty old and likely concerns topics that are avoidable by using more modern tools and techniques. The original text is preserved below for posterity but it may no longer be relevant or correct.

Writing the previous post brought about a problem: How can I write posts about Liquid tags?

By default, any Jekyll file containing YAML front matter will be churned through the Liquid processor. This means that any blog posts, which require YAML front matter, that contain Liquid tags will have them processed producing unwanted results.

The few solutions to this problem I’ve seen monkey-patch Jekyll. This works but was a little messy for me, so I went with a JavaScript approach.

Instead of writing my posts with Liquid tags , I simply substitute in ERB-style brackets.

<% for post in site.posts %>
  <%= post.title %>
  <% include post.json %>
<% endfor %>

The above will be transformed in to

<% for post in site.posts %>
  <%= post.title %>
  <% include post.json %>
<% endfor %>

The replacement is done with JavaScript via replaceERBTags($el), where $el is a jQuery object of the element containing the tags to be replaced. The function itself is nothing complex, in fact it’s so simple I can’t show it because it can’t escape itself! So you’ll have to be content with viewing it on GitHub.

Syntax Highlighting

Pygments, the syntax highlighter used by Jekyll, doesn’t support Liquid so we can’t get pretty markup. The syntax highlighting above is due to me using a <% highlight erb %> block. Because I target $('code.text') elements for tag replacements, i.e. <% highlight text %> blocks, I needed to use a different lexer to show the ERB tags.

You could target code.erb elements instead, but then you lose the use of ERB tags! I’m not a fan of Liquid, so I plan on doing as few posts on it as possible, hence I’m happier with ERB support. (Plus, any syntax highlighting you did get would only be approximate, and I expect would break down if you had anything but raw Liquid.)