Link Abbreviations

Here are demos of link abbreviations used in Markdown. The creation of link abbreviations is the same as in Org Mode.

To create a link abbreviation, in the front matter add the abbreviation and its full form in a link_abbr in the link_abbrs array, like this:

link_abbrs:
  - link_abbr: foo https://i.postimg.cc/Vv8jFw8D/

Then you can use the abbreviation in links throughout the document. It will be expanded to the full form in the built site.

Below are the supported use cases of link abbreviations.

Here is an image:

![](foo:unsplash-gallery-image-1.jpg)

Figure

Links written in Liquid syntax are also supported. For example, here is a figure:

{% include figure image_path="foo:unsplash-gallery-image-1.jpg" popup=true
alt="" caption="A figure" %}
A figure

You can create a gallery as usual in Minimal Mistakes. The extra benefit is that now you can use link abbreviations in it, like this:

---
link_abbrs:
  - link_abbr: foo https://i.postimg.cc/Vv8jFw8D/
gallery2:
  - url: foo:unsplash-gallery-image-1.jpg
    image_path: foo:unsplash-gallery-image-1.jpg
    title: Here is a [link]({{ site.baseurl }}/docs/dark-mode/) in title.
  - image_path: foo:unsplash-gallery-image-1.jpg
  - foo:unsplash-gallery-image-1.jpg
---

{% include gallery id="gallery2" columns=6 caption="A gallery using link abbreviations " %}

All the link forms shown above can be expanded correctly to the same image path:

A gallery using link abbreviations

Loading Local Files

A gallery loading local files:

---
symlinks:
  - /assets/archive/image/foo ~/Downloads/temp/archive/image/foo
link_abbrs:
  - link_abbr: foo2 /assets/archive/image/foo/
gallery3:
  - url: foo2:unsplash-gallery-image-1.jpg
    image_path: foo2:unsplash-gallery-image-1.jpg
    title: Here is a [link]({{ site.baseurl }}/docs/dark-mode/) in title.
  - image_path: foo2:unsplash-gallery-image-1.jpg
  - foo2:unsplash-gallery-image-1.jpg
---

{% include gallery id="gallery3" columns=6 caption="A gallery using link abbreviations " %}
A gallery using link abbreviations

Furigana

You can write furigana for Japanese Kanji words like the following:

本｜日（ほん｜じつ）はお時｜間（じ｜かん）をいただき、ありがとうございます。私は
マカオにあるマカオ理｜工｜大｜学（り｜こう｜だい｜がく）を4年｜制（ねん｜せい）
の学｜士（がく｜し）課｜程（か｜てい）で卒業（そつ｜ぎょう）しました。

本｜日（ほん｜じつ）はお時｜間（じ｜かん）をいただき、ありがとうございます。私はマカオにあるマカオ理｜工｜大｜学（り｜こう｜だい｜がく）を4年｜制（ねん｜せい）の学｜士（がく｜し）課｜程（か｜てい）で卒業（そつ｜ぎょう）しました。

You can also write furigana for Katakana（English） pairs, that is, if matched, put the English above the Katakana word just like furigana. For example:

クラウド（cloud）ネイティブ（native）なマルチテナント（multi-tenant）型バックエ
ンド（backend）プラットフォーム（platform）の設計、クラウドプラットフォーム
（cloud platform）、モビリティサービス（mobility service）

クラウド（cloud）ネイティブ（native）なマルチテナント（multi-tenant）型バックエンド（backend）プラットフォーム（platform）の設計、クラウドプラットフォーム（cloud platform）、モビリティサービス（mobility service）

Updated: