Github Markdown mesmo link da página

107

Digamos que eu tenha dois pontos dentro da mesma página wiki git hub, que chamaremos de place 1e 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).

Uma alternativa é um ToC.

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

Há alguma maneira de fazer isso? Observação - visto isso , vou assumir que está no tópico. Além disso, trata-se de alternar entre arquivos, este trata de alternar entre o mesmo arquivo.

— Alexander Craggs
fonte

1

possível duplicata de Como você cria e vincula a uma âncora nomeada no Multimarkdown

— flyx

@flyx - Obrigado, se funcionar, responderei de volta =)

— Alexander Craggs

2

esta resposta é provavelmente a mais relevante para você.

— flyx

@flyx Um pouco atrasado, mas obrigado! Isso realmente me ajudou muito :)

— Alexander Craggs

145

Isso funciona no 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).

Resumo das regras de conversão:

os sinais de pontuação serão eliminados
os espaços em branco à esquerda serão eliminados
maiúsculas serão convertidas em minúsculas
espaços entre letras serão convertidos para -

Um bom documento de exemplo com muitos links e formatação é o Guia de design de API do LivingSocial

— FelixEnescu
fonte

2

Observe que o próprio link ref deve ser codificado em minúsculas. Usando o exemplo acima, se você vincular a [here](#Place-2), o link não funcionará. Observe como no exemplo, o título é denominado "Local 2" e o link para ele é (corretamente) denominado [here](#place-2).

— DaveL17 de

6

Se você tem 2 ou mais posições com o mesmo nome Placeas ligações serão nomeados place, place-1, place-2, etc. Então, se você também tem um cabeçalho explícita Place 2sua ligação será place-2-1.

— Kevin

1

A resposta ainda é útil, pois funciona no Gitlab Wiki. O método html (usando a tag âncora no wiki do gitlab) não funciona. Eu entendo que a pergunta era sobre o github.

— Nditah

Parece não ser compatível com o BitBucket. Eu uso a âncora <a name="link"> em vez disso.

— рüффп

26

Também é possível criar âncoras personalizadas nomeadas, se, por exemplo, você tiver um monte de (sub) cabeçalhos com o mesmo nome. Para fazer isso com um cabeçalho, insira uma tag HTML:

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

Em seguida, faça um link para ele pelo atributo ID:

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

Além disso, adicionar uma tag âncora diretamente ao documento também funciona:

<a id="my-anchor"></a>

— gado
fonte

2

Obrigado, esta solução funciona muito bem e por um motivo. As alterações na redução do GIT no ano passado evitam que os títulos sejam adicionados como #my headingmais devem ser # my headinge adicionar um espaço na âncora como (# my-heading)se não funcionasse

— MitchellK

0

Infelizmente, parece que o wiki do GitHub remove todas as tags "id = .." do HTML personalizado que você adiciona a uma página wiki, portanto, as únicas âncoras de trabalho dentro de uma página são os títulos.

— cpurdy
fonte

0

Copiado do GitHub Gist - a postagem original localizada aqui

Para criar links de âncora que vão para diferentes seções de um README (como em um sumário interativo), primeiro crie um título:

#Real Cool Heading

O link de âncora para esse título é o nome do título em minúsculas com traços onde há espaços. Você sempre pode obter o nome da âncora visitando o README no Github.com e clicando na âncora que aparece quando você passa o mouse à esquerda do título. Copie tudo começando em #:

#real-cool-heading

Sempre que você quiser criar um link para a seção Real Cool Heading, coloque o texto desejado entre colchetes, seguido pelo link de âncora entre parênteses:

[Go to Real Cool Heading section](#real-cool-heading)

— EladTal
fonte