Skip to content

Markdown pages have no runs of blank lines #1797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
shadromani wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Markdown pages have no runs of blank lines #1797

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e7df6e4
Collapse runs of blank lines in the Markdown output
shadromani Oct 26, 2026
e9cafd4
Drop the trailing blank lines from section pages
shadromani Oct 26, 2026
8a387de
End a section page with one newline when it has no list
shadromani Oct 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions layouts/_default/list.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
{{ partial "markdown/front-matter.md" . }}
{{- $body := partial "markdown/body.md" . }}
{{ with $body }}{{ . }}

{{ end -}}
{{ $body }}
{{- /* Leave out the children that the body already links, for example in a
link group, so the page does not list them twice. */ -}}
{{- $unlinked := slice -}}
Expand All @@ -11,7 +9,13 @@
{{- $unlinked = $unlinked | append . -}}
{{- end -}}
{{- end -}}
{{- with $unlinked -}}
{{- /* End the body with a newline, and add a blank line before the list.
A page with no body needs neither. */ -}}
{{- if $body }}
{{ end -}}
{{- with $unlinked }}
{{- if $body }}
{{ end -}}
## Pages in this section

{{ range . -}}
Expand Down
12 changes: 12 additions & 0 deletions layouts/partials/markdown/body.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,4 +23,16 @@
{{- end -}}
{{- end -}}
{{- end -}}
{{- /* Shortcodes and their source leave runs of blank lines. One blank line
separates blocks just as well and costs fewer tokens. Keep the runs
inside fenced code, where they are part of the sample: swap each
fence for a placeholder, collapse the runs, and swap the fences back. */ -}}
{{- $fences := findRE "(?ms)^[ \t]*```.*?^[ \t]*```[ \t]*$" $body -}}
{{- range $i, $fence := $fences -}}
{{- $body = replace $body $fence (printf "\x00%d\x00" $i) -}}
{{- end -}}
{{- $body = replaceRE `\n([ \t]*\n){2,}` "\n\n" $body -}}
{{- range $i, $fence := $fences -}}
{{- $body = replace $body (printf "\x00%d\x00" $i) $fence -}}
{{- end -}}
{{- $body | strings.TrimSpace -}}
Loading