hugo-theme-relearn/exampleSite/content/cont/markdown.en.md

813 lines
27 KiB
Markdown
Raw Normal View History

+++
tags = ["Content"]
2024-04-04 21:30:53 +00:00
title = "Markdown Syntax"
weight = 4
+++
Let's face it: Writing content for the web is tiresome. WYSIWYG editors help alleviate this task, but they generally result in horrible code, or worse yet, ugly web pages.
**Markdown** is a better way to write **HTML**, without all the complexities and ugliness that usually accompanies it.
Some of the key benefits are:
1. Markdown is simple to learn, with minimal extra characters so it's also quicker to write content.
2. Less chance of errors when writing in Markdown.
3. Produces valid HTML output.
4. Keeps the content and the visual display separate, so you cannot mess up the look of your site.
5. Write in any text editor or Markdown application you like.
6. Markdown is a joy to use!
John Gruber, the author of Markdown, puts it like this:
> The overriding design goal for Markdowns formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like its been marked up with tags or formatting instructions. While Markdowns syntax has been influenced by several existing text-to-HTML filters, the single biggest source of inspiration for Markdowns syntax is the format of plain text email.
2021-10-12 16:49:24 +00:00
> <cite>John Gruber</cite>
{{% notice tip %}}
2024-04-04 21:30:53 +00:00
{{% icon bookmark %}} Bookmark this page for easy future reference!
{{% /notice %}}
2024-04-04 21:30:53 +00:00
## Standard and Extensions
2024-04-04 17:59:51 +00:00
If not otherwise noted, the shown examples adhere to the [Commonmark](https://commonmark.org/help/) standard. In addition the theme supports the following extensions that [can be activated](https://gohugo.io/getting-started/configuration-markup/#goldmark) in your `hugo.toml` or are built into the theme:
2024-04-04 17:59:51 +00:00
2024-04-04 21:30:53 +00:00
- {{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} Extension on top of standard Markdown adhering to [GitHub Flavored Markdown](https://github.github.com/gfm/).
- {{% badge color="#888cc4" icon="fa-fw fab fa-markdown" %}}PHP{{% /badge %}} Extension on top of standard Markdown adhering to [PHP Markdown](https://michelf.ca/projects/php-markdown/extra/).
2024-04-04 22:29:32 +00:00
- {{% badge color="darkorange" icon="lightbulb" %}}Pants{{% /badge %}} Extension by John Gruber adhering to [SmartyPants](https://daringfireball.net/projects/smartypants/).
2024-04-04 21:30:53 +00:00
- {{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" %}}Hugo{{% /badge %}} [Hugo Extra Extension](https://github.com/gohugoio/hugo-goldmark-extensions?tab=readme-ov-file#extras-extension) supported by Hugo.
2024-04-07 22:20:47 +00:00
- {{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} Extension specific to this theme.
2024-04-07 22:14:49 +00:00
- {{% badge color="orangered" icon="fa-fw fas fa-code" %}}HTML{{% /badge %}} If the [usage of HTML](https://gohugo.io/getting-started/configuration-markup/#rendererunsafe) is allowed, the theme supports styling for further HTML elements.
2024-04-04 17:59:51 +00:00
## Paragraphs
In Markdown your content usually spans the whole available document width. This is called a block. Blocks are always separated by whitespace to their adjacent blocks in the resulting document.
Any text not starting with a special sign is written as normal, plain text paragraph block and must be separated to its adjacent blocks by empty lines.
2024-03-02 10:04:52 +00:00
````md
Lorem ipsum dolor sit amet, graecis denique ei vel, at duo primis mandamus.
Et legere ocurreret pri, animal tacimates complectitur ad cum. Cu eum inermis inimicus efficiendi. Labore officiis his ex, soluta officiis concludaturque ei qui, vide sensibus vim ad.
````
{{% notice style="code" icon="eye" title="Result" %}}
Lorem ipsum dolor sit amet, graecis denique ei vel, at duo primis mandamus.
Et legere ocurreret pri, animal tacimates complectitur ad cum. Cu eum inermis inimicus efficiendi. Labore officiis his ex, soluta officiis concludaturque ei qui, vide sensibus vim ad.
{{% /notice %}}
## Headings
A good idea is to structure your content using headings and subheadings. HTML-headings from `h1` through `h6` are constructed with a `#` for each level.
In Hugo you usually don't use `h1` as this is generated by your theme and you should only have one such element in a document.
2024-03-02 10:04:52 +00:00
````md
# h1 Heading
2020-06-01 12:30:02 +00:00
## h2 Heading
2020-06-01 12:30:02 +00:00
### h3 Heading
2020-06-01 12:30:02 +00:00
#### h4 Heading
2020-06-01 12:30:02 +00:00
##### h5 Heading
2020-06-01 12:30:02 +00:00
###### h6 Heading
````
{{% notice style="code" icon="eye" title="Result" %}}
# h1 Heading
## h2 Heading
### h3 Heading
2020-06-01 12:30:02 +00:00
#### h4 Heading
##### h5 Heading
###### h6 Heading
{{% /notice %}}
2023-06-09 22:21:58 +00:00
## Horizontal Rules
To further structure your content you can add horizontal rules. They create a "thematic break" between paragraph blocks. In Markdown, you can create it with three consecutive dashes `---`.
2024-03-02 10:04:52 +00:00
````md
Lorem ipsum dolor sit amet, graecis denique ei vel, at duo primis mandamus.
---
Et legere ocurreret pri, animal tacimates complectitur ad cum. Cu eum inermis inimicus efficiendi. Labore officiis his ex, soluta officiis concludaturque ei qui, vide sensibus vim ad.
````
{{% notice style="code" icon="eye" title="Result" %}}
Lorem ipsum dolor sit amet, graecis denique ei vel, at duo primis mandamus.
2020-06-01 12:30:02 +00:00
---
Et legere ocurreret pri, animal tacimates complectitur ad cum. Cu eum inermis inimicus efficiendi. Labore officiis his ex, soluta officiis concludaturque ei qui, vide sensibus vim ad.
{{% /notice %}}
## Blockquotes
For quoting blocks of content from another source within your document add `>` before any text you want to quote.
Blockquotes can also be nested.
````md
> Donec massa lacus, ultricies a ullamcorper in, fermentum sed augue. Nunc augue, aliquam non hendrerit ac, commodo vel nisi.
>
> > Sed adipiscing elit vitae augue consectetur a gravida nunc vehicula. Donec auctor odio non est accumsan facilisis. Aliquam id turpis in dolor tincidunt mollis ac eu diam.
>
> Mauris sit amet ligula egestas, feugiat metus tincidunt, luctus libero. Donec congue finibus tempor. Vestibulum aliquet sollicitudin erat, ut aliquet purus posuere luctus.
````
{{% notice style="code" icon="eye" title="Result" %}}
> Donec massa lacus, ultricies a ullamcorper in, fermentum sed augue. Nunc augue, aliquam non hendrerit ac, commodo vel nisi.
>
> > Sed adipiscing elit vitae augue consectetur a gravida nunc vehicula. Donec auctor odio non est accumsan facilisis. Aliquam id turpis in dolor tincidunt mollis ac eu diam.
>
> Mauris sit amet ligula egestas, feugiat metus tincidunt, luctus libero. Donec congue finibus tempor. Vestibulum aliquet sollicitudin erat, ut aliquet purus posuere luctus.
{{% /notice %}}
## Alerts
2024-08-13 11:44:01 +00:00
{{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} Since Hugo {{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" %}}0.132.0{{% /badge %}} [GitHub styled alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) are also supported. Please note, that coloring and icons of severities may defer between GitHub and this theme.
If you are in need of more advanced options to style your alerts, use the [notice shortcode](shortcodes/notice).
````md
> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.
> [!IMPORTANT]
> Key information users need to know to achieve their goal.
> [!INFO]
> Information that users <ins>_might_</ins> find interesting.
> [!NOTE]
> Useful information that users should know, even when skimming content.
> [!TIP]
> Helpful advice for doing things better or more easily.
> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.
````
{{% notice style="code" icon="eye" title="Result" %}}
> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.
> [!IMPORTANT]
> Key information users need to know to achieve their goal.
> [!INFO]
> Information that users <ins>_might_</ins> find interesting.
> [!NOTE]
> Useful information that users should know, even when skimming content.
> [!TIP]
> Helpful advice for doing things better or more easily.
> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.
{{% /notice %}}
## Text Markers
### Bold
2020-06-01 12:30:02 +00:00
You can show importance of a snippet of text with a heavier font-weight by enclosing it with two asterisks `**`.
2024-03-02 10:04:52 +00:00
````md
I am rendered with **bold text**
````
{{% notice style="code" icon="eye" title="Result" %}}
I am rendered with **bold text**
{{% /notice %}}
### Italics
2020-06-01 12:30:02 +00:00
You can emphasize a snippet of text with italics by enclosing it with underscores `_`.
2024-03-02 10:04:52 +00:00
````md
I am rendered with _italicized text_
````
{{% notice style="code" icon="eye" title="Result" %}}
I am rendered with _italicized text_
{{% /notice %}}
### Marked Text
2020-06-01 12:30:02 +00:00
You can mark text in the predefined accent color of your stylesheet.
{{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" %}}Hugo{{% /badge %}} Since Hugo 0.126.0, you can [activate this through the _Hugo Extra Extension_](https://github.com/gohugoio/hugo-goldmark-extensions?tab=readme-ov-file#extras-extension) in your `hugo.toml`
2020-06-01 12:30:02 +00:00
2024-03-02 10:04:52 +00:00
````md
==Parts== of this text ==are marked!==
````
{{% badge color="orangered" icon="fa-fw fas fa-code" %}}HTML{{% /badge %}} You can also use it by configuring Hugo for [usage of HTML](https://gohugo.io/getting-started/configuration-markup/#rendererunsafe).
````html
<mark>Parts</mark> of this text <mark>are marked!</mark>
````
2018-11-02 00:15:46 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
<mark>Parts</mark> of this text <mark>are marked!</mark>
{{% /notice %}}
### Inserted Text
You can mark text additions to existing text.
{{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" %}}Hugo{{% /badge %}} Since Hugo 0.126.0, you can [activate this through the _Hugo Extra Extension_](https://github.com/gohugoio/hugo-goldmark-extensions?tab=readme-ov-file#extras-extension) in your `hugo.toml`
````md
The ++hot, new++ stuff
````
{{% badge color="orangered" icon="fa-fw fas fa-code" %}}HTML{{% /badge %}} You can also use it by configuring Hugo for [usage of HTML](https://gohugo.io/getting-started/configuration-markup/#rendererunsafe).
2024-04-04 21:30:53 +00:00
````html
The <ins>hot, new</ins> stuff
2024-04-04 21:30:53 +00:00
````
{{% notice style="code" icon="eye" title="Result" %}}
The ++hot, new++ stuff
2024-04-04 21:30:53 +00:00
{{% /notice %}}
### Deleted Text
{{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} You can do strikethroughs by enclosing text with two tildes `~~`. See [Hugo's documentation remarks](https://gohugo.io/getting-started/configuration-markup/#extras) if you want to use this together with the subscript syntax.
````md
~~Strike through~~ this text
````
{{% notice style="code" icon="eye" title="Result" %}}
~~Strike through~~ this text
{{% /notice %}}
2024-04-04 21:30:53 +00:00
## Special Typesetting
### Text Substitution
{{% badge color="darkorange" icon="lightbulb" %}}Pants{{% /badge %}} You can combine multiple punctuation characters to single typographic entities. This will only be applied to text outside of code blocks or inline code.
2024-03-02 10:04:52 +00:00
````md
Double quotes `"` and single quotes `'` of enclosed text are replaced by **"double curly quotes"** and **'single curly quotes'**.
Double dashes `--` and triple dashes `---` are replaced by en-dash **--** and em-dash **---** entities.
Double arrows pointing left `<<` or right `>>` are replaced by arrow **<<** and **>>** entities.
Three consecutive dots `...` are replaced by an ellipsis **...** entity.
````
{{% notice style="code" icon="eye" title="Result" %}}
Double quotes `"` and single quotes `'` of enclosed text are replaced by **"double curly quotes"** and **'single curly quotes'**.
Double dashes `--` and triple dashes `---` are replaced by en-dash **--** and em-dash **---** entities.
Double arrows pointing left `<<` or right `>>` are replaced by arrow **<<** and **>>** entities.
Three consecutive dots `...` are replaced by an ellipsis **...** entity.
{{% /notice %}}
### Subscript and Superscript
2024-04-04 21:30:53 +00:00
You can also use subscript and superscript text. For more complex stuff, you can use the [`math` shortcode](shortcodes/math).
{{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" %}}Hugo{{% /badge %}} Since Hugo 0.126.0, you can [activate this through the _Hugo Extra Extension_](https://github.com/gohugoio/hugo-goldmark-extensions?tab=readme-ov-file#extras-extension) in your `hugo.toml`
````md
How many liters H~2~O fit into 1dm^3^?
````
{{% badge color="orangered" icon="fa-fw fas fa-code" %}}HTML{{% /badge %}} You can also use it by configuring Hugo for [usage of HTML](https://gohugo.io/getting-started/configuration-markup/#rendererunsafe).
2024-04-04 21:30:53 +00:00
````html
How many liters H<sub>2</sub>O fit into 1dm<sup>3</sup>?
2024-04-04 21:30:53 +00:00
````
{{% notice style="code" icon="eye" title="Result" %}}
How many liters H~2~O fit into 1dm^3^?
2024-04-04 21:30:53 +00:00
{{% /notice %}}
### Keyboard Shortcuts
2024-04-04 21:30:53 +00:00
{{% badge color="orangered" icon="fa-fw fas fa-code" %}}HTML{{% /badge %}} You can use the `<kbd>` element to style keyboard shortcuts.
2024-04-04 21:30:53 +00:00
````html
Press <kbd>STRG</kbd> <kbd>ALT</kbd> <kbd>DEL</kbd> to end your shift early.
2024-04-04 21:30:53 +00:00
````
{{% notice style="code" icon="eye" title="Result" %}}
Press <kbd>STRG</kbd> <kbd>ALT</kbd> <kbd>DEL</kbd> to end your shift early.
2024-04-04 21:30:53 +00:00
{{% /notice %}}
## Lists
### Unordered
2020-06-01 12:30:02 +00:00
You can write a list of items in which the order of the items does not explicitly matter.
It is possible to nest lists by indenting an item for the next sublevel.
You may use any of `-`, `*` or `+` to denote bullets for each list item but should not switch between those symbols inside one whole list.
2024-03-02 10:04:52 +00:00
````md
- Lorem ipsum dolor sit amet
- Consectetur adipiscing elit
- Vestibulum laoreet porttitor sem
- Ac tristique libero volutpat at
- Nulla volutpat aliquam velit
- Phasellus iaculis neque
- Purus sodales ultricies
- Faucibus porta lacus fringilla vel
````
{{% notice style="code" icon="eye" title="Result" %}}
- Lorem ipsum dolor sit amet
- Consectetur adipiscing elit
- Vestibulum laoreet porttitor sem
- Ac tristique libero volutpat at
- Nulla volutpat aliquam velit
- Phasellus iaculis neque
- Purus sodales ultricies
- Faucibus porta lacus fringilla vel
{{% /notice %}}
### Ordered
You can create a list of items in which the order of items does explicitly matter.
It is possible to nest lists by indenting an item for the next sublevel.
2020-06-01 12:30:02 +00:00
Markdown will automatically number each of your items consecutively. This means, the order number you are providing is irrelevant.
2024-03-02 10:04:52 +00:00
````md
1. Lorem ipsum dolor sit amet
3. Consectetur adipiscing elit
1. Integer molestie lorem at massa
7. Facilisis in pretium nisl aliquet
99. Nulla volutpat aliquam velit
1. Faucibus porta lacus fringilla vel
1. Aenean sit amet erat nunc
17. Eget porttitor lorem
````
{{% notice style="code" icon="eye" title="Result" %}}
1. Lorem ipsum dolor sit amet
1. Consectetur adipiscing elit
1. Integer molestie lorem at massa
7. Facilisis in pretium nisl aliquet
99. Nulla volutpat aliquam velit
1. Faucibus porta lacus fringilla vel
1. Aenean sit amet erat nunc
17. Eget porttitor lorem
{{% /notice %}}
### Tasks
2024-04-04 21:30:53 +00:00
{{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} You can add task lists resulting in checked or unchecked non-clickable items
2024-03-02 10:04:52 +00:00
````md
- [x] Basic Test
- [ ] More Tests
- [x] View
- [x] Hear
- [ ] Smell
````
{{% notice style="code" icon="eye" title="Result" %}}
- [x] Basic Test
- [ ] More Tests
- [x] View
- [x] Hear
- [ ] Smell
{{% /notice %}}
2020-06-01 12:30:02 +00:00
2023-04-18 13:29:21 +00:00
### Definitions
2024-04-04 21:30:53 +00:00
{{% badge color="#888cc4" icon="fa-fw fab fa-markdown" %}}PHP{{% /badge %}} Definition lists are made of terms and definitions of these terms, much like in a dictionary.
A definition list in Markdown Extra is made of a single-line term followed by a colon and the definition for that term. You can also associate more than one term to a definition.
If you add empty lines around the definition terms, additional vertical space will be generated. Also multiple paragraphs are possible
2024-03-02 10:04:52 +00:00
````md
Apple
: Pomaceous fruit of plants of the genus Malus in the family Rosaceae.
: An American computer company.
Orange
: The fruit of an evergreen tree of the genus Citrus.
You can make juice out of it.
: A telecommunication company.
You can't make juice out of it.
````
{{% notice style="code" icon="eye" title="Result" %}}
Apple
: Pomaceous fruit of plants of the genus Malus in the family Rosaceae.
: An American computer company.
Orange
: The fruit of an evergreen tree of the genus Citrus.
You can make juice out of it.
: A telecommunication company.
You can't make juice out of it.
{{% /notice %}}
## Code
### Inline Code
Inline snippets of code can be wrapped with backticks `` ` ``.
2024-03-02 10:04:52 +00:00
````md
In this example, `<div></div>` is marked as code.
````
{{% notice style="code" icon="eye" title="Result" %}}
In this example, `<div></div>` is marked as code.
{{% /notice %}}
### Indented Code Block
A simple code block can be generated by indenting several lines of code by at least two spaces.
2024-03-02 10:04:52 +00:00
````md
Be impressed by my advanced code:
// Some comments
line 1 of code
line 2 of code
line 3 of code
````
{{% notice style="code" icon="eye" title="Result" %}}
Be impressed by my advanced code:
// Some comments
line 1 of code
line 2 of code
line 3 of code
{{% /notice %}}
### Fenced Code Block
If you want to gain more control of your code block you can enclose your code by at least three backticks ```` ``` ```` a so called fence.
2024-04-04 21:30:53 +00:00
{{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} You can also add a language specifier directly after the opening fence, ` ```js `, and syntax highlighting will automatically be applied according to the selected language in the rendered HTML.
2023-10-24 20:49:34 +00:00
See [Code Highlighting](shortcodes/highlight) for additional documentation.
````plaintext
```js
2024-04-04 21:30:53 +00:00
{
name: "Claus",
surname: "Santa",
profession: "courier",
age: 666,
address: {
city: "North Pole",
postalCode: 1,
country: "Arctic"
},
2024-04-04 21:30:53 +00:00
friends: [ "Dasher", "Dancer", "Prancer", "Vixen", "Comet", "Cupid", "Donder", "Blitzen", "Rudolph" ]
};
```
````
{{% notice style="code" icon="eye" title="Result" %}}
```js
2024-04-04 21:30:53 +00:00
{
name: "Claus",
surname: "Santa",
profession: "courier",
age: 666,
address: {
city: "North Pole",
postalCode: 1,
country: "Arctic"
},
2024-04-04 21:30:53 +00:00
friends: [ "Dasher", "Dancer", "Prancer", "Vixen", "Comet", "Cupid", "Donder", "Blitzen", "Rudolph" ]
};
```
{{% /notice %}}
## Tables
2024-04-04 21:30:53 +00:00
{{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} You can create tables by adding pipes as dividers between each cell, and by adding a line of dashes (also separated by bars) beneath the header. Note that the pipes do not need to be vertically aligned.
2024-03-02 10:04:52 +00:00
````md
| Option | Description |
|--------|-------------|
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |
````
{{% notice style="code" icon="eye" title="Result" %}}
| Option | Description |
|--------|-------------|
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |
{{% /notice %}}
### Aligned Columns
Adding a colon on the left and/or right side of the dashes below any heading will align the text for that column accordingly.
2024-03-02 10:04:52 +00:00
````md
| Option | Number | Description |
|-------:|:------:|:------------|
| data | 1 | path to data files to supply the data that will be passed into templates. |
| engine | 2 | engine to be used for processing templates. Handlebars is the default. |
| ext | 3 | extension to be used for dest files. |
````
{{% notice style="code" icon="eye" title="Result" %}}
| Option | Number | Description |
|-------:|:------:|:------------|
| data | 1 | path to data files to supply the data that will be passed into templates. |
| engine | 2 | engine to be used for processing templates. Handlebars is the default. |
| ext | 3 | extension to be used for dest files. |
{{% /notice %}}
## Links
### Autolink
2024-04-04 21:30:53 +00:00
{{% badge color="darkgray" icon="fa-fw fab fa-github" %}}GFM{{% /badge %}} Absolute URLs will automatically be converted into a link.
2024-03-02 10:04:52 +00:00
````md
This is a link to https://example.com.
````
{{% notice style="code" icon="eye" title="Result" %}}
This is a link to https://example.com.
{{% /notice %}}
### Basic Link
You can explicitly define links in case you want to use non-absolute URLs or want to give different text.
2024-03-02 10:04:52 +00:00
````md
[Assemble](http://assemble.io)
````
{{% notice style="code" icon="eye" title="Result" %}}
[Assemble](http://assemble.io)
{{% /notice %}}
### Link with Tooltip
For even further information, you can add an additional text, displayed in a tooltip on hovering over the link.
2024-03-02 10:04:52 +00:00
````md
[Upstage](https://github.com/upstage/ "Visit Upstage!")
````
{{% notice style="code" icon="eye" title="Result" %}}
[Upstage](https://github.com/upstage/ "Visit Upstage!")
{{% /notice %}}
2022-12-02 15:05:06 +00:00
### Link References
Links can be simplyfied for recurring reuse by using a reference ID to later define the URL location. This simplyfies writing if you want to use a link more than once in a document.
2024-03-02 10:04:52 +00:00
````md
2022-12-02 15:05:06 +00:00
[Example][somelinkID]
[somelinkID]: https://example.com "Go to example domain"
````
{{% notice style="code" icon="eye" title="Result" %}}
2022-12-02 15:05:06 +00:00
[Example][somelinkID]
[somelinkID]: https://example.com "Go to example domain"
{{% /notice %}}
### Footnotes
2024-04-04 21:30:53 +00:00
{{% badge color="#888cc4" icon="fa-fw fab fa-markdown" %}}PHP{{% /badge %}} Footnotes work mostly like reference-style links. A footnote is made of two things, a marker in the text that will become a superscript number and a footnote definition that will be placed in a list of footnotes.
Usually the list of footnotes will be shown at the end of your document. If we use a footnote in a notice box it will instead be listed at the end of its box.
Footnotes can contain block elements, which means that you can put multiple paragraphs, lists, blockquotes and so on in a footnote. It works the same as for list items, just indent the following paragraphs by four spaces in the footnote definition.
2024-03-02 10:04:52 +00:00
````md
That's some text with a footnote[^1]
2022-07-16 10:07:29 +00:00
[^1]: And that's the footnote.
2020-06-01 12:30:02 +00:00
That's some more text with a footnote.[^someid]
[^someid]:
Anything of interest goes here.
Blue light glows blue.
````
{{% notice style="code" icon="eye" title="Result" %}}
That's some text with a footnote[^1]
2022-10-08 19:38:42 +00:00
[^1]: And that's the footnote.
That's some more text with a footnote.[^someid]
[^someid]:
Anything of interest goes here.
Blue light glows blue.
2022-10-08 19:38:42 +00:00
{{% /notice %}}
## Images
### Basic Images
2022-10-08 19:38:42 +00:00
Images have a similar syntax to links but include a preceding exclamation mark.
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Spock](https://octodex.github.com/images/spocktocat.png)
````
{{% notice style="code" icon="eye" title="Result" %}}
![Spock](https://octodex.github.com/images/spocktocat.png?width=20vw)
{{% /notice %}}
2020-06-01 12:30:02 +00:00
2022-12-02 15:05:06 +00:00
### Image with Tooltip
Like links, images can also be given a tooltip.
2020-06-01 12:30:02 +00:00
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Picard](https://octodex.github.com/images/jean-luc-picat.jpg "Jean Luc Picard")
````
2020-06-01 12:30:02 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
2022-10-08 19:38:42 +00:00
![Picard](https://octodex.github.com/images/jean-luc-picat.jpg?width=20vw "Jean Luc Picard")
{{% /notice %}}
### Image References
Images can also be linked by reference ID to later define the URL location. This simplyfies writing if you want to use an image more than once in a document.
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![La Forge][laforge]
2022-10-08 19:38:42 +00:00
[laforge]: https://octodex.github.com/images/trekkie.jpg "Geordi La Forge"
````
{{% notice style="code" icon="eye" title="Result" %}}
2022-10-08 19:38:42 +00:00
![La Forge][laforge]
2022-10-08 19:38:42 +00:00
[laforge]: https://octodex.github.com/images/trekkie.jpg?width=20vw "Geordi La Forge"
{{% /notice %}}
### Image Effects
2024-04-12 15:30:16 +00:00
{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the image URL. The default [behavior is configurable](cont/imageeffects) through your `hugo.toml` or frontmatter parameter.
#### Resizing
Add query parameter `width` and/or `height` to the link image to resize the image. Values are CSS values (default is `auto`).
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Minion](https://octodex.github.com/images/minion.png?width=20vw)
````
{{% notice style="code" icon="eye" title="Result" %}}
![Minion](https://octodex.github.com/images/minion.png?width=20vw)
{{% /notice %}}
2021-08-27 16:21:12 +00:00
2024-03-02 10:04:52 +00:00
````md
![Minion](https://octodex.github.com/images/minion.png?height=50px)
````
{{% notice style="code" icon="eye" title="Result" %}}
![Minion](https://octodex.github.com/images/minion.png?height=50px)
{{% /notice %}}
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Minion](https://octodex.github.com/images/minion.png?height=50px&width=40vw)
````
{{% notice style="code" icon="eye" title="Result" %}}
![Minion](https://octodex.github.com/images/minion.png?height=50px&width=40vw)
{{% /notice %}}
#### CSS Classes
Add a query parameter `classes` to the link image to add CSS classes. Add some of the predefined values or even define your own in your CSS.
2022-10-08 19:38:42 +00:00
##### Shadow
2024-03-02 10:04:52 +00:00
````md
![Spidertocat](https://octodex.github.com/images/spidertocat.png?classes=shadow)
````
2020-06-01 12:30:02 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
![Spidertocat](https://octodex.github.com/images/spidertocat.png?width=20vw&classes=shadow,noborder)
{{% /notice %}}
2022-10-08 19:38:42 +00:00
##### Border
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![DrOctocat](https://octodex.github.com/images/droctocat.png?classes=border)
````
2020-06-01 12:30:02 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
![DrOctocat](https://octodex.github.com/images/droctocat.png?width=20vw&classes=border,noshadow)
{{% /notice %}}
2022-10-08 19:38:42 +00:00
##### Left
2022-10-08 19:38:42 +00:00
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Supertocat](https://octodex.github.com/images/okal-eltocat.jpg?classes=left)
````
2022-10-08 19:38:42 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
2022-10-08 19:38:42 +00:00
![Supertocat](https://octodex.github.com/images/okal-eltocat.jpg?width=20vw&classes=left)
{{% /notice %}}
2022-10-08 19:38:42 +00:00
##### Right
2022-10-08 19:38:42 +00:00
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Riddlocat](https://octodex.github.com/images/riddlocat.jpg?classes=right)
````
2022-10-08 19:38:42 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
2022-10-08 19:38:42 +00:00
![Riddlocat](https://octodex.github.com/images/riddlocat.jpg?width=20vw&classes=right)
{{% /notice %}}
2022-10-08 19:38:42 +00:00
##### Inline
2024-03-02 10:04:52 +00:00
````md
2022-10-08 19:38:42 +00:00
![Spidertocat](https://octodex.github.com/images/spidertocat.png?classes=inline)
![DrOctocat](https://octodex.github.com/images/droctocat.png?classes=inline)
![Supertocat](https://octodex.github.com/images/okal-eltocat.jpg?classes=inline)
![Riddlocat](https://octodex.github.com/images/riddlocat.jpg?classes=inline)
````
2020-06-01 12:30:02 +00:00
{{% notice style="code" icon="eye" title="Result" %}}
![Spidertocat](https://octodex.github.com/images/spidertocat.png?width=10vw&classes=inline)
2022-10-08 19:38:42 +00:00
![DrOctocat](https://octodex.github.com/images/droctocat.png?width=10vw&classes=inline)
![Supertocat](https://octodex.github.com/images/okal-eltocat.jpg?width=10vw&classes=inline)
![Riddlocat](https://octodex.github.com/images/riddlocat.jpg?width=10vw&classes=inline)
{{% /notice %}}
##### Combination
2024-03-02 10:04:52 +00:00
````md
![X-tocat](https://octodex.github.com/images/xtocat.jpg?classes=shadow,border,left)
````
{{% notice style="code" icon="eye" title="Result" %}}
![X-tocat](https://octodex.github.com/images/xtocat.jpg?width=20vw&classes=shadow,border,left)
{{% /notice %}}
#### Lightbox
Add the query parameter `lightbox=false` to the image link to disable the lightbox.
2024-03-02 10:04:52 +00:00
````md
![Homercat](https://octodex.github.com/images/homercat.png?lightbox=false)
````
{{% notice style="code" icon="eye" title="Result" %}}
![Homercat](https://octodex.github.com/images/homercat.png?width=20vw&lightbox=false)
{{% /notice %}}
{{% notice note %}}
If you want to wrap an image in a link and `lightbox=true` is your default setting, you have to explicitly disable the lightbox to avoid it to hijacking your link like:
2024-03-02 10:04:52 +00:00
````md
[![Homercat](https://octodex.github.com/images/homercat.png?lightbox=false)](https://octodex.github.com/#homercat)
````
[![Homercat](https://octodex.github.com/images/homercat.png?width=20vw&lightbox=false)](https://octodex.github.com/#homercat)
{{% /notice %}}