Skip to content

Instantly share code, notes, and snippets.

Forked from vanto/
Last active December 21, 2020 13:53
Show Gist options
  • Save internaut/11403000 to your computer and use it in GitHub Desktop.
Save internaut/11403000 to your computer and use it in GitHub Desktop.

OEmbed Liquid Tag for Jekyll

This is a simple liquid tag that helps to easily embed images, videos or slides from OEmbed enabled providers. It uses Magnus Holm's great oembed gem which connects to the OEmbed endpoint of the link's provider and retrieves the HTML code to embed the content properly (i.e. an in-place YouTube player, Image tag for Flickr, in-place slideshare viewer etc.). By default it supports the following OEmbed providers (but can fallback to or OoEmbed for other providers):

  • Youtube
  • Flickr
  • Viddler
  • Qik
  • Revision3
  • Hulu
  • Vimeo
  • Instagram
  • Slideshare
  • Yfrog
  • MlgTv

How to install

  1. Make sure you have the ruby-oembed gem (Rubygems, Github) installed.
  2. Copy oembed.rb to <your-jekyll-project>/_plugins
  3. You're done.

If you're experiencing troubles with Ruby 2.x, please also add require 'openssl' to the script.

How to use

Place a oembed tag in your content file. E.g.

<h1>An embedded video</h1>
{{ oembed }}

<h1>An embedded video with width/height dimensions</h1>
{{ oembed 640 480 }}

<h1>An embedded presentation</h1>
{{ oembed }}

The oembed tag behaves almost compatible to Robert Böhnke's Tag, i.e. it wraps the embed code in a <div> tag that has classes matching the embeds type, provider as well as the generic embed. In contrast to the tag, we don't support overriding certain oembed properties.


Tammo van Lessen --

Author of max.width/height modification

Markus Konrad --


This code snippet is licensed under Apache License 2.0

# OEmbed Liquid Tag for Jekyll
# - requires
# Copyright 2011 Tammo van Lessen
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# See the License for the specific language governing permissions and
# limitations under the License.
require 'oembed'
require 'uri'
# register all default OEmbed providers
# since register_all does not register all default providers, we need to do this here. See
::OEmbed::Providers.register(::OEmbed::Providers::Instagram, ::OEmbed::Providers::Slideshare, ::OEmbed::Providers::Yfrog, ::OEmbed::Providers::MlgTv)
::OEmbed::Providers.register_fallback(::OEmbed::ProviderDiscovery, ::OEmbed::Providers::Embedly, ::OEmbed::Providers::OohEmbed)
module Jekyll
class OEmbed < Liquid::Tag
def initialize(tag_name, markup, tokens)
# parse optional max. width/height parameters
@text, @embed_w, @embed_h = markup.split
def render(context)
# pipe param through liquid to make additional replacements possible
url = Liquid::Template.parse(@text).render context
# oembed look up
# additionally add max. width/height parameters
result = ::OEmbed::Providers.get(url, { :format => :xml, :maxwidth => @embed_w, :maxheight => @embed_h })
# Odd: slideshare uses provider-name instead of provider_name
provider = result.fields['provider_name'] || result.fields['provider-name'] || 'unknown'
"<div class=\"embed #{result.type} #{provider}\">#{result.html}</div>"
Liquid::Template.register_tag('oembed', Jekyll::OEmbed)
Copy link

inetbiz commented Dec 21, 2020

jekyll 3.9.0 | Error: This server doesn't have the correct libraries installed to support the 'xml' format

{% if page.oembed %}{% for url in page.oembed %}
                      {% oembed {{url}} 640 480 %}{% endfor %} 
{% endif %}</div>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment