Skip to content

Invalid link: '<a href="#...">...</a>'. The file index.md doesn't contain a bookmark named '...' #5233

@davikor

Description

@davikor

Operation System: Windows

DocFX Version Used: 2.46

Template used: default

Steps to Reproduce:

  1. download extract attached example
  2. run docfx.exe docfx.json

Expected Behavior:

Build succeeds without warnings

Actual Behavior:

Build succeeds with one warning: Invalid link: '<a href="#anchor-with-umlaut-%C3%A4">Link to anchor</a>'. The file index.md doesn't contain a bookmark named 'anchor-with-umlaut-%C3%A4'

DocFx seems to url-encode special characters (e.g. german Umlaute) in links but does not url encode the anchor names that are being generated for each heading, therefore the warning I guess. Firefox seems to be okay with that (it can navigate the links) but of course it is not obvious anymore whether ones link is really invalid or whether it just contains characters that got url encoded.

Metadata

Metadata

Assignees

No one assigned

    Labels

    static-siteProduce static HTML output ready for publishing to hosts like GitHub pages

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions