Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • G gitlabhq1
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 21
    • Issues 21
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 12
    • Merge requests 12
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Infrastructure Registry
  • Analytics
    • Analytics
    • CI/CD
    • Repository
    • Value stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • gpt
  • large_projects
  • gitlabhq1
  • Issues
  • #3628

Closed
Open
Created Apr 18, 2013 by Administrator@rootOwner

Readable MD file section linking

Created by: chocostar

I would like from a MD doc this doc.md to be able to link to [relative path...]/another doc.md#some particular section.

But in the rendered HTML, where I can see my some particular section title, there's a h2 tag, and a <a> anchor, with an id like toc_13 or whatever, instead of having something like <a id="some particular section">, or <a id="some-particular-section"> or even <a id="SomeParticularSection">.

Having to link to another doc section this way: doc.md#toc_13 is not a good practice in my opinion, since it is readable (what lies behind "toc_13" ?), and not maintainable, since in the real document, the header can go from being the 13th one, to the 16th one, or the 8th one, or whatever.

I believe this is linked the automatic TOC generation capability. But in my case, generating a TOC for every document is not relevant. I rather need the possibility to link to a particular section in a document from anywhere, in a readable fashion.

That way, MD + GitLab could serve as a very simple wiki system, without additional plugin (like Gollum or so).

I thank in advance anyone reading this and answering. Thanks a lot for your time!

Assignee
Assign to
Time tracking