A media tag for Hexo 3.x

Usage no npm install needed!

<script type="module">
  import hexoTagOwl from 'https://cdn.skypack.dev/hexo-tag-owl';



NPM version Code Climate License

An useful media tag for Hexo 3.x, Demo page



Run the following command in the root directory of hexo:

npm install hexo-tag-owl --save


Component Concept

All components are wrapped by a <div> tag with several classes. All components have at least one class .owl-media:

<div class="owl-media">[component]</div>

Auto Stylesheet Embedding

Because the components are lack of CSS, everyone can add some CSS for one's preference. Here provide a default CSS written in stylus at lib/asset/css.styl.

  css: default
  file: owl.css
  • css: whether insert default stylesheet or not, with following values
    • default: use default stylesheet at lib/asset/css.styl
    • custom: use custom stylesheet with path at file
    • none: unable this feature
    • default values: none
  • file: assign the path of stylesheet when css is not none, and default value is owl.css


Every components of this category have additional class .owl-video.

<div class="owl-media owl-video">[component]</div>

Each videos source will add additional class .owl-[source]:

  • Youtube: .owl-youtube
  • Niconico: .owl-niconico
  • Bilibili: .owl-bilibili
  • Vimeo: .owl-vimeo
  • Tudou: .owl-tudou
  • Youku: .owl-youku
  • Tencent: .owl-tencent
  • TED: .owl-ted


{% owl youtube youtube_id %}
{% owl niconico niconico_id [type] %}
{% owl bilibili bilibili_id [page] %}
{% owl vimeo vimeo_id %}
{% owl tudou tudou_id %}
{% owl youku youku_id %}
{% owl tencent tencent_id %}
{% owl ted ted_id [lang] %}
  • youtube_id - video id on Youtube
  • vimeo_id - video id in Vimeo.
  • Niconico
    • niconico_id - video id in Niconico.
    • type - embeded type. There are only thumb and watch two options. Default is set as thumb.
      • thumb: set nico in thumb mode with extra class .niconico-thumb
      • watch: set nico in watch mode with extra class .niconico-watch
  • Bilibili
    • bilibili_id - video id in Bilibili. You can use either av247371 or 247371.
    • page - if video have several clips, you can add a number indicated the video.
  • tudou_id - video id in Tudou.
  • youku_id - video id in Youku. You can use either id_XMTc3MzcxMjQw or XMTc3MzcxMjQw.
  • tencent_id - video id in Tencent Video.
  • TED
    • ted_id - video id in TED.
    • lang - subtitle language for TED videos.


{% owl youtube YtuAOT_c2EA %}
{% owl niconico sm1494658 %}
{% owl niconico sm1494658 watch %}
{% owl bilibili av247371 %}
{% owl bilibili 247371 %}
{% owl bilibili av367901 2 %}
{% owl vimeo 5566538 %}
{% owl tudou pRsx83aRLLs %}
{% owl youku id_XMTc3MzcxMjQw %}
{% owl tencent o03134mlm8j %}
{% owl ted gero_miesenboeck zh-cn %}


Every components of this category have additional class .owl-image.

<div class="owl-media owl-image">[component]</div>

Local Images

Insert your image from blog's path.


{% owl local image_path %}
  • image_path - relative path from your blog.


{% owl local img/img.jpg %}
{% owl local another-img.gif %}


Insert your gif from Giphy.


{% owl giphy giphy_id %}
  • giphy_id - giphy id


{% owl giphy AxqJJOBkWHXW %}


  • Tao Wang: Tencent (騰訊視頻) plugin function
  • Riff: TED videos plugin support