paragraph linking is broken

[Veykril]

[PLeVasseur]

Hey @tshepang -- is this still the case? And if so, where? I'd like the context added to the body of the issue.

[tshepang]

an example of a pr that failed when I tried to avoid the linking problem is #583