Encontrei várias menções ao suporte do MultiMarkdown para links internos / âncoras nomeadas, mas não consigo encontrar um único exemplo de como fazê-lo.
Então, qual é a sintaxe para denotar a âncora nomeada e qual é a sintaxe para vincular a ela da mesma forma que vincular a qualquer outra URL (usando apenas #foo em vez de http://....
)?
markdown
multimarkdown
masukomi
fonte
fonte
Respostas:
No Markdown padrão, coloque uma âncora na
<a name="abcd"></a>
qual deseja vincular e faça referência a ela na mesma página por[link text](#abcd)
.(Isso usa
name=
e nãoid=
, pelos motivos explicados nesta resposta .)Referências remotas podem ser usadas, é
[link text](http://...#abcd)
claro.Isso funciona como um sonho, desde que você tenha controle sobre os textos de origem e de destino. A âncora pode até aparecer em um cabeçalho, assim:
produz:
Um título nesta entrada SO!
e podemos até criar um link para isso:
(No SO, o link não funciona porque a âncora é removida.)
fonte
<a id="id"></a>
formulário é melhor. Veja esta pergunta / resposta do SO .name=
foi preterido em XHTML, mas agora acho queid=
tem um efeito colateral no HTML5, por isso estou voltando aname=
esta resposta.Se você tiver cabeçalhos nos arquivos de remarcação, poderá vinculá-los diretamente no arquivo.
Cabeçalho de remarcação -
## The Header
isso irá gerar um ID implícito
#the-header
(substitua espaços internos por hífens e faça letras minúsculas).Para navegar para esse ID, você pode criar o link assim:
[Link to Header](#the-header)
Isso é equivalente a:
<a href="#the-header">Link to Header</a>
Observe que o nome da referência é minúsculo
#header
.fonte
## This Header ##
, o link seria[To This Header](#markdown-header-this-header)
. Se você não tiver certeza de qual é o ID do seu cabeçalho, use um inspetor de página para ver os valores HTML.[Link](user-content-the-header)
Retirado do Guia do Usuário do Multimarkdown (obrigado a @MultiMarkdown no Twitter por apontá-lo)
[Some Text][]
vinculará a um cabeçalho chamado "Some Text",por exemplo
Um rótulo opcional de sua escolha para ajudar a desambiguar casos em que vários cabeçalhos têm o mesmo título:
fonte
Testei o Github Flavored Markdown por um tempo e posso resumir com quatro regras:
-
Por exemplo, se sua seção for nomeada como esta:
Crie um link para ele desta maneira:
fonte
A melhor maneira de criar links internos (relacionados às seções) é criar lista, mas em vez de link, coloque #section ou # section-title se o cabeçalho incluir espaços.
---- MARKDOWN ------------------------
---- LIST PREVIEW ------------------------
---- HTML ------------------------
Não importa se é o cabeçalho h1, h2, h3, etc., você sempre se refere a ele usando apenas um
#
.Todas as referências na lista de seções devem ser convertidas em texto em minúsculas, conforme mostrado no exemplo acima.
O link para a seção deve estar em minúsculas. De outra maneira, não vai funcionar.
Essa técnica funciona muito bem para todas as variantes do Markdown, também para o MultiMarkdown.
Atualmente estou usando o Pandoc para converter o formato de documentos. É muito melhor que o MultiMarkdown.
Teste o Pandoc aqui
fonte
## Hello
deverá referir-se a ele como #[Whatever you want](#Hello)
No mdcharm, é assim:
fonte
Aqui está a minha solução (derivada da
SaraubhM
resposta)**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
O que lhe dá:
Ir para : Teclas de Atalho e Marcadores / Raios / Assistente de Rota 2.0
Observe as alterações de
e
.
para-
e também a perda de&
nos links.fonte