hexo-filter-titlebased-link

Transfer wiki links (based on the title) in Markdown files to permalink.

将基于标题的双向链接转换为 Hexo 设定的永久链接。

This plugin makes you easy to use wiki links (its form may be [[Title]] [[Title#Anchor]] or [[Title|Alias]]) in Hexo. It would be more useful when you use Obsidian to manage your blogs. In addition, it allows you to customize the rendered HTML links.

[!NOTE]

• For the plugin to work as expected, make sure the titles of all your articles are unique.

Installation

1npm install hexo-filter-titlebased-link --save

Quick Start

To configure this plugin, add these contents in the _config.yml:

1# hexo-filter-titlebased-link
2# https://github.com/uuanqin/hexo-filter-titlebased-link
3titlebased_link:
4  enable: true   # enable this plugin

Hexo sets every post a Permalinks, which can be configured in the _config.yml.

Here is an example:

1# in _config.yml
2permalink: p/:year/:month/:day/:hour/:minute/:second/

Assume you have a post named my_post_1 whose permalink is p/2024/04/12/14/18/50/. In another post named my_post_2, you wrote a wiki link to my_post_1:

1This is my_post_2, 
2
3you can click this link: [[my_post_1]],
4
5or [[my_post_1|Any title]].

After rendering by Hexo, the resultant HTML file of my_post_2.md will be:

1<p>This is my_post_2, </p>
2<p>you can click this link: <a href="/p/2024/04/12/14/18/50/">my_post_1</a>,</p>
3<p>or <a href="/p/2024/04/12/14/18/50/">Any title</a>.</p>

Customize Your Links

Similar to the hexo-filter-custom-link, this plugin reserves several slots for custom HTML.

1`
2${config.custom_html.before_tag}
3    <a ${config.custom_html.link_attributes} href="/p/2024/04/12/14/18/50/">
4        ${config.custom_html.before_text}
5        my_post_1
6        ${config.custom_html.after_text}
7    </a>
8${config.custom_html.after_tag}
9`

For example, if your option is:

1titlebased_link:
2  enable: true   # enable this plugin
3  custom_html:
4    link_attributes: 'class="my-link" title="example"'
5    before_tag: '<p class="my-p"> Before the link '
6    after_tag: ' After the link </p>'
7    before_text: ''
8    after_text: ''

Then the resultant HTML will be (the code below was formatted for ease of review):

1<p class="my-p"> 
2    Before the link
3    <a class="my-link" title="example" href="/p/2024/04/12/14/18/50/">this link</a>
4    After the link 
5</p>

Related Hexo Plugins

• hexo-filter-custom-link: Customize the rendered HTML of Links. 自定义链接渲染后的 HTML。
• hexo-filter-link-post: Transfer relative post link in markdown file to post link. 将文件里的通过相对路径引用的 markdown 文件转为对应的文章的链接。
• hexo-abbrlink: Create one and only link for every post for hexo. 为每一篇 Hexo 文章创建独一无二的永久链接。

更多 Obsidian 语法插件推荐详见我的博客文章 Hexo 博客适配 Obsidian 新语法。

License

MIT