html - straight - Referência cruzada(âncora nomeada) no markdown



markdown inner reference (6)

Em bitbucket.org, a solução votada não funcionaria. Em vez disso, ao usar cabeçalhos (com ##), é possível referenciá-los como âncoras prefixando-os como # markdown-header-my-header-name, onde # markdown-header- é um prefixo implícito gerado pelo renderizador e o resto é o título de cabeçalho com caixa baixa com traços substituindo espaços.

Exemplo

## My paragraph title

irá produzir uma âncora implícita como esta

#markdown-header-my-paragraph-title

A URL inteira antes de cada referência de âncora é opcional, ou seja,

[Some text](#markdown-header-my-paragraph-title)

é equivalente a

[Some text](https://bitbucket.org/some_project/some_page#markdown-header-my-paragraph-title) 

desde que estejam na mesma página.

Fonte: https://bitbucket.org/tutorials/markdowndemo/overview (edite a fonte desse arquivo .md e veja como as âncoras são feitas).

https://ffff65535.com

Existe uma sintaxe de marcação para o equivalente a:

Take me to <a href="#pookie">pookie</a>

... 

<a name="pookie">this is pookie</a>

Não há sintaxe prontamente disponível para fazer isso na sintaxe Markdown original, mas o Markdown Extra fornece um meio de, pelo menos, atribuir IDs a cabeçalhos - que você pode vincular facilmente a ele. Observe também que você pode usar HTML regular no Markdown e no Markdown Extra e que o atributo name foi substituído pelo atributo id em versões mais recentes do HTML.


Para quem está procurando uma solução para este problema no GitBook. É assim que eu fiz isso funcionar (no GitBook). Você precisa marcar seu cabeçalho explicitamente, assim:

# My Anchored Heading {#my-anchor}

Em seguida, ligue para esta âncora como este

[link to my anchored heading](#my-anchor)

Solução e exemplos adicionais podem ser encontrados aqui: https://seadude.gitbooks.io/learn-gitbook/


Tarde para a festa, mas acho que essa adição pode ser útil para pessoas que trabalham com rmarkdown . No rmarkdown há suporte embutido para referências a cabeçalhos em seu documento.

Qualquer cabeçalho definido por

# Header

pode ser referenciado por

get me back to that header(#header)

Segue-se um ficheiro .rmd autónomo mínimo que mostra este comportamento. Pode ser feito em .pdf e .html .

---
title: "references in rmarkdown"
output:
  html_document: default
  pdf_document: default
---

# Header

Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. 

Go back to that [header](#header).

O Markdown Anchor suporta o hashmark, portanto, um link para uma âncora na página seria simplesmente [Pookie](#pookie)

Gerar a âncora não é realmente suportado no Gruber Markdown, mas está em outras implementações, como o Markdown Extra .

No Markdown Extra, o ID da âncora é anexado a um cabeçalho ou subtítulo com {#pookie} .

O Github Flavored Markdown em páginas do repositório Git (mas não em Gists) gera automaticamente âncoras com várias tags de marcação em todos os cabeçalhos (h1, h2, h3, etc.), incluindo:

  • id="user-content-HEADERTEXT"
  • class="anchor"
  • href="#HEADERTEXT"
  • aria-hidden="true" (isto é para um ícone de link svg que aparece ao passar o mouse)

Excluindo o ícone aria / svg, quando se escreve:

  • # Header Title

O Github gera:

  • <h1><a id="user-content-header-title" class="anchor" href="#header-title">Header Title</a></h1>

Portanto, não é necessário fazer nada para criar os links de cabeçalho e sempre pode vinculá-los a:

  • Link para o [Header Title](#header-title)

Use um name . Usar um id não é necessário no HTML 5 e criar variáveis ​​globais em seu JavaScript

Veja a especificação do HTML 5, 5.9.8 Navegando para um identificador de fragmento - o id e o name são usados.

É importante saber que a maioria dos navegadores ainda transforma IDs em variáveis ​​globais . Aqui está um teste rápido . Usar um name evita a criação de globals e quaisquer conflitos que possam resultar.

Exemplo usando um nome:

Take me to [pookie](#pookie)

E a âncora de destino:

### <a name="pookie"></a>Some heading




cross-reference