Referencing repository files at a given commit in gitlab wiki

Question

Gitlab Markdown has support for references to files in the repository structure, like:

[README](doc/README)

or

[README](doc/README#L13)

But are there ways to reference files and lines in these files, but from a given commit, at least in the Wiki ?

Maybe something like:

[README](1ab3fa71:doc/README#L13)

or using the file hash id like:

[README](9a27b101#L13)

Answer 1

To use relative links from wiki to the repository (or wise versa) is not supported officially according to Gitlab's documentation (v11.5):

Note: Relative links do not allow referencing project files in a wiki page or wiki page in a project file. The reason for this is that, in GitLab, wiki is always a separate Git repository. For example, I'm a reference-style link will point the link to wikis/style when the link is inside of a wiki markdown file.

There is, however, a syntax which seems to work currently:

[[README|/../blob/1ab3fa71/doc/README#L13]]

But be aware: all text of the same paragraph will just be lost!

I work around that by phrasing like this, which renders like expected for Gitlab CE v11.3.0 at least:

Here you see xyz:
* [[README|/../blob/1ab3fa71/doc/README#L13]]

The root-anchored link (/../blob/<version>/<path-to-file>) ensures that it works from every Wiki page independently from their nesting depth. For sure this syntax also works for branch names or any other relative link like /../tree/1ab3fa71/doc for example.

Answer 2

Maybe long after the battle, but I found a workaround : Simply make a link to a page where the README.md is. And that's it !

To get the link simply go to a page which displays the document, copy the URL, make a link to that address, append #L with the line number.

Exemple :

[Readme Pelargos](http://192.168.80.250:10080/project-root/android/Pelargos/blob/develop/README.md#L47)