Links#
Sintaxe clássica#
Para definir um link use a seguinte sintaxe:
- [Link_texto](Link_URL)
Markdown | HTML | Renderização |
---|---|---|
|
<a href="/markdown/image/">Sou um link relativo a outra página (no mesmo diretório) do web site</a>
|
Sou um link relativo a outra página (no mesmo diretório) do web site |
|
<a href="/markdown/">Sou um link relativo a outra página (página principal) do web site</a>
|
Sou um link relativo a outra página (página principal) do web site |
|
<a href="/markdown/image/">Sou um link absoluto a outra página do website</a>
|
Sou um link absoluto a outra página do website |
|
<a href="/images/favicon.png">Sou um link absoluto a um recurso estático do web site</a>
|
Sou um link absoluto a um recurso estático do web site |
|
<a href="#link">Sou um link a um ID de um título</a>
|
Sou um link a um ID de um título |
|
<a href="/">Sou um link para a página principal</a>
|
Sou um link para a página principal |
|
<a href="/fr/">Sou um link para a página principal em outro idioma</a>
|
Sou um link para a página principal em outro idioma |
|
<a href="https://www.duckduckgo.com">Sou um link externo</a>
|
Sou um link externo |
Links que não contém uma URL são prefixados com base na configuração baseURL
.
Por exemplo:
baseURL | Markdown | Renderização |
---|---|---|
/ | [](/markdown/link/) | href="/markdown/link/" |
http://myWebsite.com/subpath/ | [](/markdown/link/) | href="/subpath/markdown/link/" |
/
são relativos ao idioma atual do web site./<RESOURCE_PATH>
is not relative to the actual website lang.Sintaxe clássica com títulos#
Para definir um link com um título use a seguinte sintaxe:
- [Link_texto](Link_URL "Link_titulo")
Markdown | HTML | Renderização |
---|---|---|
|
<a title="E eu sou seu título" href="#sintaxe-classica-com-titulos">Sou um link</a>
|
Sou um link |
Sintaxe alternativa#
Para definir um link externo é possível usar sintaxes alternativas:
- Escreva a URL do link (a renderização será realizada automaticamente pelo conversor de markdown).
- Inclua o link dentro do símbolo menor (<) e maior que (>).
Markdown | HTML | Renderização |
---|---|---|
|
<a href="https://www.duckduckgo.com">https://www.duckduckgo.com</a>
|
https://www.duckduckgo.com |
|
<a href="https://www.duckduckgo.com">https://www.duckduckgo.com</a>
|
https://www.duckduckgo.com |
|
<a href="mailto:foo@bar.com">foo@bar.com</a>
|
foo@bar.com |
Escapar um link#
Para escapar um link (mostrar a URL como texto) e evitar que seja renderizado automaticamente pelo conversor de markdown é possível usar sintaxe alternativa:
- Adicionar acento (`) antes e depois da URL do link (define o link como um fragmento de código).
- Escapar a primeira barra (/) da URL.
Markdown | HTML | Renderização |
---|---|---|
|
<p>https://www.duckduckgo.com</p>
|
https://www.duckduckgo.com |
|
<p>https://www.duckduckgo.com</p>
|
https://www.duckduckgo.com |
Enfatizar um link#
Para enfatizar um link inclua o código de markdown com qualquer código que permita enfatizar. Se o link for um fragmento de código use acento (`) dentro do texto do link (dentro do parêntese).
Markdown | HTML | Renderização |
---|---|---|
|
<em><br><a href="/markdown/link/">Sou um link em itálico</a>
</em>
|
Sou um link em itálico |
|
<strong><br><a href="/markdown/link/">Sou um link em negrito</a>
</strong>
|
Sou um link em negrito |
|
<em><strong><br><a href="/markdown/link/">Sou um link em itálico e negrito</a>
</strong></em>
|
Sou um link em itálico e negrito |
|
<a href="/markdown/link/">
<code>Sou um link num fragmento de código</code>
</a>
|
Sou um link num fragmento de código |
Links referenciados#
Para definir um link no qual a URL é referenciada (por conseguinte, reutilizável), deve ser formatado em duas partes.
-
Primeira parte (link do texto)
Para definir a primeira parte do link, que corresponde ao texto que será renderizado e uma referência para ser definida na segunda parte, use a seguinte sintaxe:
- [Link_texto][Link_URL_referencia]
A referência para a URL não é caso sensível e pode conter caracteres alfa numéricos, espaços e pontuação. -
Segunda parte (link referência)
Para definir a segunda parte do link, que é o link entre a URL de referência definida na primeira parte e o valor da URL use uma das seguintes sintaxes:
- [Link_URL_referencia]: Link_URL
- [Link_URL_referencia]: Link_URL "Link_titulo"
- [Link_URL_referencia]: Link_URL 'Link_titulo'
- [Link_URL_referencia]: Link_URL (Link_titulo)
- <[Link_URL_referencia]>: Link_URL "Link_titulo"
- <[Link_URL_referencia]>: Link_URL 'Link_titulo'
- <[Link_URL_referencia]>: Link_URL (Link_titulo)
A segunda parte do link pode ser incluída em qualquer lugar no documento. Por exemplo: todas as referências no documento podem ser agrupadas ao final do mesmo, para melhorar a legibilidade e por simplicidade.
Markdown | HTML | Renderização |
---|---|---|
|
<a href="#referenced-link">Sou um link</a>
<a href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
|
<a title="E eu sou seu título" href="#referenced-link">Sou um link</a>
<a title="E eu sou seu título" href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
|
<a title="E eu sou seu título" href="#referenced-link">Sou um link</a>
<a title="E eu sou seu título" href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
|
<a title="E eu sou seu título" href="#referenced-link">Sou um link</a>
<a title="E eu sou seu título" href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
|
<a title="E eu sou seu título" href="#referenced-link">Sou um link</a>
<a title="E eu sou seu título" href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
|
<a title="E eu sou seu título" href="#referenced-link">Sou um link</a>
<a title="E eu sou seu título" href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
|
<a title="E eu sou seu título" href="#referenced-link">Sou um link</a>
<a title="E eu sou seu título" href="#referenced-link">Sou um segundo link</a>
<p>Sou um texto</p>
|
Sou um texto |
Links com espaços#
Para definir um link cuja URL contém espaço codifique a URL associando com o código de espaço para caractere (%20).
Markdown | HTML | Renderização |
---|---|---|
|
<a href="https://www.duckduckgo.com/?query=Hugo%20themes">Temas de Hugo</a>
|
Temas de Hugo |
ID links (específico por tema)#
Para definir um ID link escreva o link seguindo a sintaxe clássica com título . O ID é adicionado automaticamente ao link (usando o tema) e o seu valor é a saída da função de Hugo anchorize com o link do título como valor de entrada:
- [Link_text](Link_URL "Link_title")
Markdown | HTML | Renderização |
---|---|---|
|
<a id="and-im-its-title" title="E eu sou seu título" href="#link-id-theme-specific">Sou um link</a>
|
Sou um link |
Ref/Relref#
Para definir um link usando ref
or relref
, siga o padrão da sintaxe de shortcodes padrão de Hugo
.
Markdown | HTML | Renderização |
---|---|---|
|
<a href="<baseURL>/markdown/image/">Sou um link ref</a>
|
Sou um link ref |
|
<a href="/markdown/image/">Sou um link relref</a>
|
Sou um link relref |