From 904b29dfa998ca491590cee2241c9ef92e16355c Mon Sep 17 00:00:00 2001
From: Dennis Fink
Date: Fri, 6 Nov 2026 18:40:14 +0100
Subject: Add permalinks to blog post headings
This adds direct permalink links to Markdown headings, making it easier
to share specific sections of a blog post.
The links appear on hover or keyboard focus and remain visible on touch
devices. They are excluded from Pagefind indexing to avoid unnecessary
search content.
---
assets/static/css/style.css | 27 ++++++++++++++++++++++
.../lektor_blog_markdown_headings.py | 6 ++---
packages/blog-markdown-headings/setup.py | 2 +-
3 files changed, 31 insertions(+), 4 deletions(-)
diff --git a/assets/static/css/style.css b/assets/static/css/style.css
index beb9cc3..c210a9b 100644
--- a/assets/static/css/style.css
+++ b/assets/static/css/style.css
@@ -653,6 +653,33 @@ article {
color: var(--green);
}
+ /* --- Heading permalinks --- */
+ & :is(h2, h3, h4, h5, h6)[id] {
+ & > a[aria-label="Permalink"] {
+ color: var(--dim-foreground);
+ font-size: 0.75em;
+ opacity: 0;
+ text-decoration: none;
+ vertical-align: center;
+
+ &:hover,
+ &:focus-visible {
+ color: var(--blue);
+ }
+ }
+
+ &:hover > a[aria-label="Permalink"],
+ &:focus-within > a[aria-label="Permalink"] {
+ opacity: 1;
+ }
+
+ @media (hover: none) {
+ & > a[aria-label="Permalink"] {
+ opacity: 1;
+ }
+ }
+ }
+
& blockquote {
font-style: italic;
border-left: 2px solid var(--blue);
diff --git a/packages/blog-markdown-headings/lektor_blog_markdown_headings.py b/packages/blog-markdown-headings/lektor_blog_markdown_headings.py
index 5293676..f7703c0 100644
--- a/packages/blog-markdown-headings/lektor_blog_markdown_headings.py
+++ b/packages/blog-markdown-headings/lektor_blog_markdown_headings.py
@@ -113,13 +113,13 @@ def renderer_mixin_factory(anchor_type, adjusted_level):
meta["toc"].append((level, anchor, Markup(text)))
- return '%s' % (level, anchor, text, level)
+ return f'{text} #'
- class RendererMixinMistune0(object):
+ class RendererMixinMistune0:
def header(self, text, level, raw):
return render_heading(text, level, self.meta, raw)
- class RendererMixinMistune2(object):
+ class RendererMixinMistune2:
def heading(self, text, level):
meta = self.lektor.meta
return render_heading(text, level, meta)
diff --git a/packages/blog-markdown-headings/setup.py b/packages/blog-markdown-headings/setup.py
index 59f9895..b924036 100644
--- a/packages/blog-markdown-headings/setup.py
+++ b/packages/blog-markdown-headings/setup.py
@@ -2,7 +2,7 @@ from setuptools import setup
setup(
name="lektor-blog-markdown-headings",
- version="0.1",
+ version="0.2",
py_modules=["lektor_blog_markdown_headings"],
entry_points={
"lektor.plugins": [
--
cgit v1.3.1