Inserting content in the middle of a Jekyll post

Do you wish to insert content (such as advertisement or a link) right in the middle of the Jekyll page? We can do that by using the content as an array and a forloop. Here is how.

If we want to insert something in the middle of a blog post, we need to separate the main content with split Liquid template filter:

{% assign content_array = page.content | split: site.excerpt_separator %}
{% assign excerpt_only = content_array | first %}
{% assign content_remainder = content_array | last %}

Above, we got an example of splitting with your excerpt separator, which should work for the regular posts and creating a content_array. Then we can show the first part, the excerpt, and the remainder by using first and last filters.

Dependending on the separator we can also append or remove leading and trailing tags:

<div class="post-excerpt">
  {{ excerpt_only | append: '</p>'}}

<div class="post-content">
  {{ content_remainder | remove_first: '</p>'}}

However, if we want a bit more flexibility, we need to use a forloop to insert a specific bloc to a specific place:

{% for block in content_array %}
  {{ block }}

  {% if forloop.index0 == 1 %}
    Inserting content in the middle!
  {% endif %}
{% endfor %}

In the snipped above, I am putting content after the second block. We can leverage forloop’s various properties to fiddle with the results:

Finally, if you have code blocks in your posts, using the default excerpt separator would break them. In such case, we have to check for language-XXX highlighter-rouge class and split accordingly by code mentions (the split is a little different, but things might work as you intented). Don’t forget to replace XXX to the language you use. Here is an example:

{% if page.content contains 'language-elixir highlighter-rouge' %}
  {% assign content_array = page.content | split: '<div class="language-elixir highlighter-rouge">' %}
{% elsif page.content contains 'highlighter-rouge' %}
  <!-- no split -->
  {% assign content_array = page.content %}
{% else %}
  {% assign content_array = page.content | split: site.excerpt_separator %}
{% endif %}


I am writing an introductory book on web application deployment. Networking, processes, systemd, backups, and all your usual suspects.

Open →