Drop footnote-references from summary if bottom_footnotes = true

ccjmne · August 25, 2025, 8:37pm

When only the page.summary is shown in a section, its footnote-references are shown but the links are broken if the site is configured with bottom_footnotes = true.

I believe it would make sense to strip the footnote references altogether from the summary in such cases. Maybe the markdown filter could take an additional optional parameter to avoid rendering footnotes altogether?

ccjmne · August 25, 2025, 8:55pm

Actually it looks like some code is supposed to be doing just that:

github.com/getzola/zola

components/markdown/src/markdown.rs

3a24aae68


      
          if has_summary {
              // Note: we render the summary separately, restarting from
              // the beginning for the actual body of the page, as cmark's html
              // renderer has internal state, such as the footnote counter,
              // that it does not expose.
              let mut summary_html = String::new();
              cmark::html::push_html(
                  &mut summary_html,
                  events.iter().cloned().take(continue_reading),
              );
              // remove footnotes
              let mut summary_html = FOOTNOTES_RE.replace_all(&summary_html, "").into_owned();

Yet I still see the <sup class=”footnote-reference”> in my summary.

ccjmne · August 26, 2025, 10:41am

Found the issue, submitted a PR:

github.com/getzola/zola

Correctly remove footnote-reference from summary

next ← ccjmne:next

opened 09:18PM - 25 Aug 25 UTC

ccjmne

+1 -1

This commit updates and fixes the regular expression to find and delete footnote… references in the pages' summaries. fecc3cf introduces the desired behaviour. 6a2b890 broke the suppression of footnote-reference in the summary by adding an id parameter to the <sup> elements for back-reference. Fixes #2961. Ref: https://zola.discourse.group/t/drop-footnote-references-from-summary-if-bottom-footnotes-true/2841/2

TL;DR: the regular expression that was locating footnote-references for deletion in summarywasn’t up to date with the introduction of an id attribute, for back-references.

Topic		Replies	Views
Place references in foot of text Feature requests	6	605	November 30, 2022
Is there a way to customise the way Zola parses Markdown footnotes? Support	8	2059	June 25, 2021
Getting markdown without paragraph	6	780	April 28, 2022
Enhanced Footnotes Feature requests	0	394	October 7, 2023
Dedicated page summary instead of "more" trickery Feature requests	9	631	October 11, 2022

Drop footnote-references from summary if bottom_footnotes = true

Related topics