Skip to content

Anchor tag bugs #125

@bmorelli25

Description

@bmorelli25

Bug summary

Bug 1

What happens
Anchor tags are only generated for H1 and H2 level headings.

What I expect to happen
Anchor tags should be generated for all heading levels.

Bug 2

What happens
If a heading includes backticks, the ID is not unique or correct. For example, the heading ## `note` creates the following anchor: markdig.syntax.inlines.codeinline. This also impacts the OTP (on this page) widget on the right side of the page:

Image

What I expect to happen
Backticks should be ignored and a unique anchor tag should be created.

Bug 3

What happens
Linking to valid anchor tags on a different page fails the link checker. For example:

[Notes](tables.md#notes)
Error: `notes` does not exist in .
    ┌─[/github/workspace/docs/source/syntax/links.md]
    │
 [35](https://github.com/elastic/docs-builder/actions/runs/12638318856/job/35214323557?pr=129#step:4:36) │ I link to the [Notes](tables.md#notes) heading on the [Tables](tables.md) page.
    ·              ───────────────                                                   
    ·                                                                                 
    │
    └─
	1 Errors / 0 Warnings

:: info: Program[0] generate :: Finished in '00:00:00.0220[37](https://github.com/elastic/docs-builder/actions/runs/12638318856/job/35214323557?pr=129#step:4:38)5

What I expect to happen
The link checker should not fail on valid anchor links.

Metadata

Metadata

Assignees

No one assigned

    Labels

    authoringRelates to our markdown parserbug

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions