feat(footnotes): add back-to-reference link for footnotes (#2699)

docs/userGuide/syntax/footnotes.md

@@ -32,6 +32,19 @@ Normal footnotes won't work when used inside the attributes of MarkBind componen
 For example, it won't work in the `header` attribute of [panels](../components/presentation.html#panels).
 </box>
 
+### Footnote Back-Link
+
+Each footnote definition now includes a back-to-reference link (“↩”)  
+that jumps back to the original marker.
+
+**Rendered HTML example:**
+
+```html
+Here is a footnote reference,[^1]
+
+[^1]: This is the footnote. <a href="#fnref1" class="footnote-backref">↩</a>
+
+
 <div id="short" class="d-none">
 
 ```html

packages/cli/test/functional/test_site/index.md

@@ -356,3 +356,17 @@ and **this**.
 <code>{{ code elements should automatically be assigned v-pre }}</code>
 
 {% endraw %}
+
+<hr>
+
+<header><h2>Footnote Back-Link Test</h2></header>
+
+This test verifies that each footnote includes a ↩ link back to its reference.
+
+Here is a footnote reference,[^1]
+
+[^1]: This is test content for footnote back-link.
+
+When rendered, you should see a ↩ after the footnote, and clicking it
+should scroll back up to the original marker.
+

packages/core/src/lib/markdown-it/plugins/markdown-it-footnotes.js

@@ -118,13 +118,8 @@ function render_footnote_anchor(tokens, idx, options, env, slf) {
     id += ':' + tokens[idx].meta.subId;
   }
 
-  // CHANGE HERE
-  // Below line adds backreferences, but doesn't work well with panels, so disabled for now.
-  // Old code:
-  // /* ↩ with escape code to prevent display as Apple Emoji on iOS */
-  // return ' <a href="#fnref' + id + '" class="footnote-backref">\u21a9\uFE0E</a>';
-
-  return '';
+  /* ↩ with escape code to prevent display as Apple Emoji on iOS */
+  return ' <a href="#fnref' + id + '" class="footnote-backref">\u21A9\uFE0E</a>';
 }