A helper makes it easy to quickly add snippets to your templates. We recommend using helpers instead of templates when you’re dealing with more complicated code.

Helpers can not be accessed from source files.

Synopsis

hexo.extend.helper.register(name, function(){
  // ...
});

Example

hexo.extend.helper.register('js', function(path){
  return '<script src="' + path + '"></script>';
});

<%- js('script.js') %>
// <script src="script.js"></script>

FAQ

Where to place custom helper?

Place it under themes/<yourtheme>/scripts

How do I use another registered helper inside my custom helper?

hexo.extend.helper.get will return the helper function, but it needs to have hexo as its context, so:

const url_for = hexo.extend.helper.get('url_for').bind(hexo);