Markdown: Links

Links#


Sintaxe clássica#

Para definir um link use a seguinte sintaxe:

  • [Link_texto](Link_URL)
Markdown HTML Renderização
[Sou um link relativo a outra página (no mesmo diretório) do web site](image/)
<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
[Sou um link relativo a outra página (página principal) 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
[Sou um link absoluto a outra página do website](/markdown/image/)
<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
[Sou um link absoluto a um recurso estático do web site](/images/favicon.png)
<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
[Sou um link a um ID de um título](#link)
<a href="#link">Sou um link a um ID de um título</a>
Sou um link a um ID de um título
[Sou um link para a página principal](/)
<a href="/">Sou um link para a página principal</a>
Sou um link para a página principal
[Sou um link para a página principal em outro idioma](/fr/)
<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
[Sou um link externo](https://www.duckduckgo.com)
<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/"
Links à página de início usando / são relativos ao idioma atual do web site.
Absolute links to resources using /<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
[Sou um link](#sintaxe-classica-com-titulos "E eu sou seu título")
<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
https://www.duckduckgo.com
<a href="https://www.duckduckgo.com">https://www.duckduckgo.com</a>
https://www.duckduckgo.com
<https://www.duckduckgo.com>
<a href="https://www.duckduckgo.com">https://www.duckduckgo.com</a>
https://www.duckduckgo.com
<foo@bar.com>
<a href="mailto:foo@bar.com">foo@bar.com</a>
foo@bar.com
Nota para realizar uma renderização amigável com os usuários é recomendado (usando Markdown Render Hooks ) usar a sintaxe clássica.

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
`https://www.duckduckgo.com`
<p>https://www.duckduckgo.com</p>
https://www.duckduckgo.com
https:\//www.duckduckgo.com
<p>https://www.duckduckgo.com</p>
https://www.duckduckgo.com

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
*[Sou um link em itálico](/markdown/link/)*
<em><br><a href="/markdown/link/">Sou um link em itálico</a> </em>
Sou um link em itálico
**[Sou um link em negrito](/markdown/link/)**
<strong><br><a href="/markdown/link/">Sou um link em negrito</a> </strong>
Sou um link em negrito
***[Sou um link em itálico e negrito](/markdown/link/)***
<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
[Sou um link num fragmento de código](/markdown/link/)
<a href="/markdown/link/"> <code>Sou um link num fragmento de código</code> </a>
Sou um link num fragmento de código

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
[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: #referenced-link
<a href="#referenced-link">Sou um link</a> <a href="#referenced-link">Sou um segundo link</a> <p>Sou um texto</p>

Sou um link

Sou um segundo link

Sou um texto

[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: #referenced-link "E eu sou seu título"
<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 link

Sou um segundo link

Sou um texto

[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: #referenced-link 'And I\'m its title'
<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 link

Sou um segundo link

Sou um texto

[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: #referenced-link (E eu sou seu título)
<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 link

Sou um segundo link

Sou um texto

[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: <#referenced-link> "E eu sou seu título"
<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 link

Sou um segundo link

Sou um texto

[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: <#referenced-link> 'And I\'m its title'
<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 link

Sou um segundo link

Sou um texto

[Sou um link][Referência A]

[Sou um segundo link][Referência A]

Sou um texto

[Referência A]: <#referenced-link> (E eu sou seu título)
<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 link

Sou um segundo link

Sou um texto

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
[Temas de Hugo](https://www.duckduckgo.com/?query=Hugo%20themes)
<a href="https://www.duckduckgo.com/?query=Hugo%20themes">Temas de Hugo</a>
Temas de Hugo

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
[Sou um link](#link-id-theme-specific "E eu sou seu título")
<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
[Sou um link ref]({{%/* ref "image/" */%}})
<a href="<baseURL>/markdown/image/">Sou um link ref</a>
Sou um link ref
[Sou um link relref]({{%/* relref "image/" */%}})
<a href="/markdown/image/">Sou um link relref</a>
Sou um link relref