Update markdown documentation for heading links
What does this MR do and why?
Updates the markdown user documentation about the new heading link generation.
Related to #440733 (closed)
MR acceptance checklist
Please evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.