Repository navigation
fix: remove {#id} heading attributes and ::: blocks the site does not render - #686
Merged
Ibochkarev merged 2 commits intoOct 23, 2026
Merged
Conversation
… support
DocsApp does not parse heading attributes: {#id} was shown in the heading
text and folded into its anchor, so links to these headings did not resolve.
Point the links at the anchors the site builds from the heading text.
…lert The site does not parse ::: container blocks, so the warning showed as plain text with the ::: markers. Use the > [!WARNING] alert the site renders.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
The site's Markdown renderer does not support two constructs that recent pages used, so these pages show raw markup on the live site.
Headings with
{#id}The renderer has no heading-attributes extension.
{#id}stays in the heading text and becomes part of its anchor:## Database caching {#database-caching}gets the anchor#database-caching-database-caching. Links to these headings did not resolve.Six headings are fixed, in
en/andru/of:extending-modx/caching/index.mdextending-modx/tutorials/using-custom-database-tables.mdThe links to them now use the anchors the site builds from the heading text, including the two links from
extending-modx/caching/lifetimes.md. The Russian anchors are transliterated the way the site does it, e.g.#programmnoe-polzovatelskoe-keshirovanie.::: warningThe site renders GitHub alerts (
> [!NOTE],> [!WARNING], …) and not:::container blocks. The one remaining::: warning, ines/building-sites/tag-syntax/date-formats.md, is now> [!WARNING], like its English page.Checks
{#and no:::block left inen/,ru/,es/,nl/on3.x. The2.xbranch has none either.markdownlint-cli@0.18on the changed files andvalidate-frontmatter.py: no issues.Not checked
Affected versions
3.x. The 2.x branch has no
{#id}headings and no:::blocks.Relevant issues
::: warningthat was left.