[Markdown] Break page into separate pieces



Because of reasons* i want to be able to break a content page into separate parts. I usually do this by splitting page.content with a separator string.

Up until a few versions ago i was using ~~~~~ or ===== to do so. However building the latest Zola seems that these chars now open a code block. Unfortunately i can’t date when the problem appeared as the last time i built my site the project was still called Gutenberg :wink:

Is this a regression or a feature? Is there a better editor-friendly character sequence i should use to replace it that i’m sure is not going to be markdownified at some point? ^^


*I think it’s very editor-friendly to have header/footer content defined in an actual page (instead of an HTML template they could break). Dividing the page into separate parts can allow to build clever multi-column layouts, among many other things



The latest version has updated the markdown parser to be CommonMark compliant.
In CommonMark, ~~~ is a way to start a code block and === a header.

You can use any characters not used in CommonMark: $, £, €, %, |, ?, !, @ etc. In short avoid =, ~, backticks, -, +, #, *, _ and you should be fine



Thanks for the answer!

Upon testing again, i figured ===== works as intended if i leave blank lines around, which sounds fair to me given that other symbols you suggested don’t really visually suggest horizontal lines breaking the content page.

1 Like