MarkDown

Overview

This Markdown cheat sheet provides a quick overview of all the Markdown syntax elements. It can’t cover every edge case, so if you need more information about any of these elements, refer to the reference guides for basic syntax and extended syntax.

Basic Syntax

Elementos de la sintaxis básica de markdown.

Elemento	Syntax
Heading	# H1 ## H2 ## H3
Paragraph	Text
Bold	bold text
Italic	italicized text
Blockquote	> blockquote
Ordered List	1. First item 2. Second item 3. Third item
Unordered List	- First item - Second item - Third item
Code	code
Horizontal	Rule —
Link	title
Image

Extended Syntax

Estos elementos extienden la sintaxis básica para agregar funcionalidad adicional.

Using Emoji Shortcodes

Some Markdown applications allow you to insert emoji by typing emoji shortcodes. These begin and end with a colon and include the name of an emoji.

Gone camping! :tent: Be back soon. That is so funny! :joy:

Simple Shortcode to Insert Raw HTML in Hugo

(https://anaulin.org/blog/hugo-raw-html-shortcode/ ) Sometimes, markdown is not enough – you might want to do a one-off extra-fancy thing with raw html. Surprisingly, Hugo doesn’t seem to have a good way to let you do this in a content file. Here is how to create your own one-line custom shortcode to make that possible.

Add a shortcode template to your site, in layouts/shortcodes/rawhtml.html, with the content:

<!-- raw html -->
{{.Inner}}

This template tells Hugo to simply render the inner content passed to your shortcode directly into the HTML of your site. You can then use this shortcode in your markdown content, like so: {{<

{{< rawhtml >}}
  <p class="speshal-fancy-custom">
    This is <strong>raw HTML</strong>, inside Markdown.
  </p>
{{< /rawhtml >}}

}}

or as simple as: {{<

{{< rawhtml >}} <br> {{< /rawhtml >}}

}}

En el caso de desplegar esta misma tabla de Extended Syntax use este shortcode asi como la inserción de los caracteres especiales “|” de la siguiente forma: {{<

| Header | \| Syntax \|  Description \| {{< rawhtml >}} <br> {{< /rawhtml >}}  \| ----------- \| ----------- \| {{< rawhtml >}} <br> {{< /rawhtml >}}\| Header \| Title \| {{< rawhtml >}} <br> {{< /rawhtml >}}\| Paragraph \| Text \| | 
| Fenced Code Block | \`\`\`{{< rawhtml >}} <br> {{< /rawhtml >}}{{{< rawhtml >}} <br> {{< /rawhtml >}}"firstName": "John",{{< rawhtml >}} <br> {{< /rawhtml >}}"lastName": "Smith",{{< rawhtml >}} <br> {{< /rawhtml >}}"age": 25{{< rawhtml >}} <br> {{< /rawhtml >}}}{{< rawhtml >}} <br> {{< /rawhtml >}}\`\`\` |

}}

Raw Text Block
{{< code >}}
{{< Texto que queremos que este como comentario (raw) >}}

Hugo - Open External Links in a New Tab

For Hugo based websites, when a link goes to an external website , I prefer to have them open in a new browser tab.

To accomplish the goal of opening all external links in a new tab, you need to override the Hugo default behavior for rendering links by creating the file layouts_defaults_markup\render-link.html. In the render-link.html, we need to look at the prefix of the .Destination to see if it starts with http or https and if it does then add the `target="_blank" Copy this code snippet into the render-link.html.

<a href=“{{ .Destination | safeURL }}”{{ with .Title}} title=“{{ . }}”{{ end }}{{ if or (strings.HasPrefix .Destination “http”) (strings.HasPrefix .Destination “https”) }} target=“_blank”{{ end }} >{{ .Text | safeHTML }}</a>

Now when any link starts with http or https, it will open in a new tab while links within the website will open in the same tab.

Obtenido del Blog de Justin James Categoría Hugo .