Solitude Docs

Tags Plugin

Use the Solitude tags plugin to write richer Markdown content.

Purpose

The tags plugin adds theme-aware shortcodes for content that plain Markdown cannot express comfortably. Use it for small visual blocks, not as a replacement for clean article structure.

Install

npm install hexo-solitude-tag
pnpm add hexo-solitude-tag
yarn add hexo-solitude-tag

Usage

After installing the plugin, restart Hexo and use the tags documented by the plugin in posts or pages.

{% note info %}
This is a highlighted note.
{% endnote %}

Good practice

  • Prefer Markdown headings, lists, and tables for ordinary writing.
  • Use theme tags when the content needs a special visual treatment.
  • Keep tags balanced and avoid nesting complex blocks deeply.
  • Test generated pages after upgrading the plugin.