Official extensions

Officially supported extensions ¶

`abbr`¶

You must always let one newline between each reference:

Output

The HTML specification is maintained by the W3C.

Markdown

The HTML specification is maintained by the W3C.

*[HTML]: Hyper Text Markup Language

*[W3C]:  World Wide Web Consortium

PO file content

msgid "The HTML specification is maintained by the W3C."
msgstr "La especificación HTML es mantenida por el W3C."

msgid "*[HTML]: Hyper Text Markup Language"
msgstr "*[HTML]: Lenguaje de Marcado de Hipertexto"

msgid "*[W3C]: World Wide Web Consortium"
msgstr "*[W3C]: Consorcio Mundial de Internet"

Only title attributes values are translated. Currently, this extension is a bit tricky because, if you want to see the title attribute value included in your PO file, you must add an attribute mdpo:

Output

link ¶

Markdown

#### [link](https://mondeja.github.io/mkdocs-mdpo-plugin){: title="With a translated title!" mdpo }

PO file content

msgid ""
"[link](https://mondeja.github.io/mkdocs-mdpo-plugin){: title=\"With a "
"translated title!\" mdpo }"
msgstr ""
"[link](https://mondeja.github.io/mkdocs-mdpo-plugin/es){: title=\"¡Con un "
"título traducido!\" mdpo }"

`def_list`¶

You must let a blank line between the term and its definition:

Output

Apple: Pomaceous fruit of plants of the genus Malus in the family Rosaceae.
Orange: The fruit of an evergreen tree of the genus Citrus.

Markdown

Apple

:   Pomaceous fruit of plants of the genus Malus in
    the family Rosaceae.

Orange

:   The fruit of an evergreen tree of the genus Citrus.

PO file content

msgid "Apple"
msgstr "Manzana"

msgid "Pomaceous fruit of plants of the genus Malus in the family Rosaceae."
msgstr "Fruto de orujo de plantas del género Malus de la familia Rosaceae."

msgid "Orange"
msgstr "Naranja"

msgid "The fruit of an evergreen tree of the genus Citrus."
msgstr "El fruto de un árbol de hoja perenne del género Citrus."

`fenced_code`¶

Code blocks are not translated by default, but you can include a ` HTML comment before each code block that you want translate.

Tip

See Code blocks extraction.

Output

var hello = "world";

Markdown

<!-- mdpo-include-codeblock -->
```javascript
var hello = "world";
```

PO file content

msgid "var hello = \"world\"; "
msgstr ""

`footnotes`¶

You must always let one newline between each footnote content:

Output

This is a footnote¹. This is another².

Markdown

This is a footnote[^1]. This is another[^2].

[^1]: This is a footnote content.

[^2]: This is another footnote content.

PO file content

msgid "This is a footnote[^1]. This is another[^2]."
msgstr "Esto es una nota al pie[^1]. Esto es otra[^2]."

msgid "[^1]: This is a footnote content."
msgstr "[^1]: Esto es el contenido de una nota al pie."

msgid "[^2]: This is another footnote content."
msgstr "[^2]: Esto es el contenido de otra nota al pie"

`tables`¶

Output

First header	Second header
Content cell	Content cell
Content cell	Content cell

Markdown

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

PO file content

msgid "First header"
msgstr "Primer encabezado"

msgid "Second header"
msgstr "Segundo encabezado"

msgid "Content cell"
msgstr "Contenido de celda"

`admonition`¶

Output

Admonition title

The title will also be included in the PO file.

Note

Even the implicit title, which in this case would be "Note".

Markdown

!!! note "Admonition title"

    Don't be afraid, the title will also be included in the PO file.

!!! note

    Even the implicit title, which in this case would be "Note".

PO file content

msgid "Admonition title"
msgstr "Título de advertencia"

msgid "The title will also be included in the PO file."
msgstr "El título también será añadido en el archivo PO."

msgid "Note"
msgstr "Nota"

msgid "Even the implicit title, which in this case would be \"Note\"."
msgstr "Incluso el título implícito, el cual en este caso sería \"Nota\"."

This is a footnote content. ↩
This is another footnote content. ↩