Lien vers la même page Github Markdown

100

Disons que j'ai deux points dans la même page wiki git hub, que nous appellerons pour cela place 1et place 2.

##Title

###Place 1

Hello, this is some text to fill in this, [here](place2), is a link to the second place.

###Place 2

Place one has the fun times of linking here, but I can also link back [here](place1).

Une alternative est une ToC.

##Title
[ToC]
###Place 1
###Place 2

Y a-t-il un moyen de faire ça? Remarque - vu cela , je suppose que c'est sur le sujet. En outre, qui traite du passage entre les fichiers, celui-ci traite du passage entre le même fichier.

Alexander Craggs
la source
@flyx - Merci, si cela fonctionne, je vous répondrai =)
Alexander Craggs
2
cette réponse est probablement la plus pertinente pour vous.
flyx
@flyx Petit peu en retard, mais merci! Cela m'a en effet aidé beaucoup :)
Alexander Craggs

Réponses:

137

Cela fonctionne sur Github:

## Title

### Place 1

Hello, this is some text to fill in this, [here](#place-2), is a link to the second place.

### Place 2

Place one has the fun times of linking here, but I can also link back [here](#place-1).

### Place's 3: other example

Place one has the fun times of linking here, but I can also link back [here](#places-3-other-example).

Résumé des règles de conversion:

  • les signes de ponctuation seront supprimés
  • les espaces blancs principaux seront supprimés
  • les majuscules seront converties en minuscules
  • les espaces entre les lettres seront convertis en -

Un bon exemple de document avec beaucoup de liens et de formatage est le guide de conception d'API LivingSocial

FelixEnescu
la source
2
Notez que le lien de référence lui-même doit être codé en minuscules. En utilisant l'exemple ci-dessus, si vous créez un lien vers [here](#Place-2), le lien ne fonctionnera pas. Notez comment dans l'exemple, l'en-tête est appelé "Place 2" et le lien vers celui-ci est (correctement) appelé [here](#place-2).
DaveL17
6
Si vous avez 2 ou plusieurs titres avec le même nom Placeles liens seront nommés place, place-1, place-2, etc. Ensuite , si vous avez également un en- tête explicite Place 2son lien sera place-2-1.
Kevin
1
La réponse est toujours utile car elle fonctionne dans Gitlab Wiki. La méthode html (utilisant la balise d'ancrage dans le wiki gitlab) ne fonctionne pas. Je comprends que la question portait sur github.
Nditah
Il ne semble pas être pris en charge dans BitBucket. J'utilise plutôt l'ancre <a name="link">.
рüффп
25

Il est également possible de créer des ancres personnalisées nommées, si par exemple vous avez un tas de (sous-) en-têtes avec le même nom. Pour ce faire avec un en-tête insérez une balise HTML:

<h4 id="login-optional-fields">
Optional Fields
</h4>

Puis liez-y par l'attribut ID:

[see above](#login-optional-fields)

L'ajout d'une balise d'ancrage directement au document fonctionne également:

<a id="my-anchor"></a>
bovins
la source
2
Merci, cette solution fonctionne un régal et pour une raison. Les modifications apportées au démarque GIT l'année dernière empêchent l'ajout de titres comme #my headingil le faut # my headinget l'ajout d'un espace dans l'ancre comme (# my-heading)ne fonctionne pas
MitchellK
0

Malheureusement, il semble que le wiki GitHub supprime toutes les balises "id = .." du HTML personnalisé que vous ajoutez à une page wiki, donc les seules ancres fonctionnelles dans une page sont les en-têtes.

cpurdy
la source