Markdown mit gohugo.

Was ist Markdown?

Markdown ist eine in Textdateien angewendete Formatierungssprache, mit der durch einfache Formatierungselemente/-befehle ein Text gestaltet werden kann. Zum Beispiel erzeugt das Formatierungselement ## eine Überschrift.

## Was ist Markdown?
   

Gohugo verwendet standardmäßig die Bibliothek Goldmark für das Übersetzten von Markdown in Html. Es ist schnell, flexibel und konform mit CommonMark.

Formatierungselemente in Markdown

Formatierungselemente sind einfache Symbole oder Sonderzeichen im Text die letztendlich mit einer Formatierungsfunktion belegt sind.

Weitere einfache Formatierungselemente sind Listen und Elemente zur Textgestaltung.

URL’s (Links) für https, Bilder, Dateien, etc.

Url’s werden im Text direkt als Link interpretiert. Allgemein können URL’s am Ende der Markdowndatei (*.md) mit einer Kurzbezeichnung definiert und im Text verwendet werden (↗Gohugo Links and Cross Reference).

• Url-Link direkt innerhalb eines Textes verwenden oder eingeschlossen mit spitzen Klammern <...>.

 https://www...
 <https://www...>
 <mail@www...>

• Url-Link direkt innerhalb eines Textes mit anderer Bezeichnung.

 [Bezeichnung](http: www...de)
 [Bezeichnung](http: www...de "Title")

• Url-Link am Ende der Markdowndatei

 Text Text Text Text Text Text 
 Text Text Text Text Text Text 
 [LinkName01][]
 [anderer Text][LinkName01]
   
 Text Text Text Text Text Text 
 
 
 [LinkName01]:	https://de.wikipedia.org

• Url-Link auf eigene Projektseite verlinken

 [Bezeichnung]:	({{< relref "/path/path/markdownfile#ueberschrift" >}} "Title")
 [code.html]:	 {{< relref "/dev/gohugo/hilfe/shortcodes#codehtml" >}}
 [git add]:	 {{< relref "git-befehle#33-git-add" >}}
   

Hinweis: Verwende ein Bindestrich bei Überschriften mit Leerzeichen und Nummerierung für die Leerzeichenüberbrückung.

Bilder verwenden

Erzeuge im Arbeitsverzeichnis das Verzeichnis static/images und speicher deine Bilder darin. In Markdowndatei (*.md) kann wie folgt die Bilddatei eingebunden werden.

 ![Alternativer Bezeichnung](/images/twitter.png)
 ![](/images/twitter.png)
 ![No Image loaded](/images/image.jpeg#border)
 ![No Image loaded](/path/to/images/image.jpeg#border)
 ![No Image loaded](/path/to/images/image.jpeg "Titel des Bildes")
 ![No Image loaded](/path/to/images/image.jpeg "Titel des Bildes {CSS Selectoren}")

Für mehr Details siehe Artikel: Bilder, Fotos, Grafiken.

Dateien als Download anbieten, bzw. statisch verlinken

Im Verzeichnis static/pdf kann eine Datei (*.pdf, *.txt, etc) abgelegt und wie folgt verwendet werden.

 [Download file](/pdf/sample.pdf)

Ergebnis:   Download file

Aufzählungslisten

Das Html-Element <li> erzeugt geordnete oder ungeordnete Listen.

Unordered Lists

 Listen können mit folgenden Aufzählungszeichen markiert werden:
 * Unordered list item 1.
 + Unordered list item 2.
 - Unordered list item 3.

Ergebnis:

• Unordered list item 1.

• Unordered list item 2.

• Unordered list item 3.

Ordered Lists

 1. ordered list item 1.
 2. ordered list item 2.
   + sub-unordered Liste beginnen mit 3 Leerzeichen gefolgt von einem + Zeichen.
   + sub-unordered list item 2.
     + [x] something is DONE.
     + [ ] something is NOT DONE.
       + sub-sub liste mit 6 Leerzeichen gefolgt von einem + Zeichen

Ergebnis:

1. ordered list item 1.
2. ordered list item 2.
   • sub-unordered Liste beginnen mit 3 Leerzeichen gefolgt von einem + Zeichen.
   • sub-unordered list item 2.
     [x] something is DONE.
     [ ] something is NOT DONE.
     • sub-sub liste mit 6 Leerzeichen gefolgt von einem + Zeichen

Definition Lists

 Zur besseren Differenzierung zwischen Text und Definitionsliste sollte eine Leerzeile (drei Leerzeichen in Markdown) vor der Definitionsliste eingefügt werden.
   
 First Term
 : This is the definition of the first term.

 Second Term
 : This is one definition of the second term.
 : This is another definition of the second term.
 : This is another definition of the second term.

Ergebnis:

Zur besseren Differenzierung zwischen Text und Definitionsliste sollte eine Leerzeile (drei Leerzeichen in Markdown) vor der Definitionsliste eingefügt werden.

First Term

This is the definition of the first term.

Second Term

This is one definition of the second term.

This is another definition of the second term.

This is another definition of the second term.

Textgestaltung mit Markdown

Textbetonung (Emphasis), Schriftstil in Markdown

 _kursiv 1_   *kursiv 2*

 __bold 1__  **bold 2**

 ___fett und kusiv 1___  ***fett und kursiv 2***

 ~~durchgestrichen~~

Hinweis: Verwende vorrangig Unterstriche (_) statt Asteriskszeichen (*).

Ergebnis:

kursiv 1 kursiv 2

bold 1 bold 2

fett und kusiv 1 fett und kursiv 2

durchgestrichen

Einfaches Texteinrücken mit Blockquotes

 > Einfaches ...
 >> und doppeltes Einruecken ...
 >>> und dreifaches Einruecken ...
 > > > oder mit Raum zwischen den Pfeilen (Arrows) ...

Ergebnis:

Einfaches …

und doppeltes Einruecken …

und dreifaches Einruecken … oder mit Raum zwischen den Pfeilen (Arrows) …

Zeilenumbruch

Ein einfacher Zeilenumbruch <br> wird in Markdown mit drei Leerzeichen in Html gerendert. Das Gleiche passiert auch wenn ein Text mit zwei Leerzeichen beginnt und endet.

Zum Beispiel:
Das ist die 1. Zeile mit zwei Leerzeichen am Beginn und am Ende
Das ist die 2. Zeile mit zwei Leerzeichen am Beginn und am Ende
Das ist die 3. Zeile mit zwei Leerzeichen am Beginn und am Ende

Textgestaltung mit HTML-Elementen

Für die Textgestaltung mit HTML-Elementen muss in der Konfigurationsdatei config.toml der Schalter unsafe gesetzt werden.

[markup]
  defaultMarkdownHandler = "goldmark" 
  [markup.goldmark]
	[markup.goldmark.renderer]
	  unsafe = true

Text hoch-, tiefgestellt

Mit dem Html-Element <sup> ... </sup> kann Text ^hochgestellt werden.
Mit dem Html-Element <sub> ... </sub> kann Text _tiefgestellt werden.

Texthilfe verwenden

Mit dem Html-Element <abbr title="Hilfetext"> ... </abbr> (abbreviation = Abkürzung) wird ein Schriftzug mit einem kleinen Hilfetext versehen wenn der Mauszeiger über den Text fährt. Zum Beispiel:

Html Seiten werden mit CSS gestaltet.

Schrift verkleinern mit <small>

Mit Hilfe des Html-Elements <small> ... </small> kann der Text in Markdown verkleinert werden.

Text für Keybord mit <kbd>

Press Enter to continue

Textumbruch

Mit der CSS-Eigenschaft hyphens wird das Verhalten für die automatische Silbentrennung festgelegt. Als Defaultwert hat die Eigenschaft hyphens: manual;. Damit kann jedes Wort, welches zu lang ist, mit dem Sonderzeichen ­ an der Stelle markiert werden, an dem eine Worttrennung erfolgen soll.

Textgestaltung mit eigenem Shortcode

Menus im Text dargestellen

Siehe dazu im Artikel Shortcodes.

Überschriften

Überschriften werden in Markdown mit dem Formatierungselement # erzeugt.

Syntax Highlights

Gohugo bietet vorbereitete Syntaxhighlights und verwendet Chroma als Code-Textmarker. Es ist in Go gebaut und sehr, sehr schnell. Für eine Demo schau mal hier und da.

Chroma Styles

In der Konfigurationsdatei (config.toml) kann ein Chroma Style zur Darstellung der Syntaxhightlight hinterlegt werden.

 pygmentsCodefences	= true
 pygmentsStyle     	= "emacs"

 # Weitere Styles sind 
 # pygmentsStyle		= "pygments"
 # pygmentsStyle		= "perldoc"
 # pygmentsStyle		= "dracule"

Global kann folgende Option mitgeben werden:

 pygmentsOptions = "linenos=table,linenostart=10"

Das ist jedoch nicht ratsam außer man verwendet eigene geänderte Styles (siehe unten). Besser ist es aber diese Option direkt vor der entsprechenden Syntax in der Markdowndatei zu setzen (siehe Beispiele Backtick’s).

Chrome Styles verändern

Auslesen eines entsprechenden Styles.

 hugo gen chromastyles --style=emacs > ./static/emacs.css 

Ergänzen der Datei: ./layouts/partials/header.html

 <link href="/emacs.css" type="text/css" rel="stylesheet" /> 

In der Konfigurationsdatei (config.toml) sind nun folgende Einstellungen notwendig:

 pygmentsCodefences = true
 # pygmentsStyle    = "emacs" # Abschalten
 pygmentsUseClasses = true
 pygmentsOptions    = "linenos=true"

Backtick

Chroma Syntaxhighlight’s werden mit Backtick’s eingeleitet oder als Shortcode {{<highlight>}}. Es kann auch das Interpunktionszeichen (Tilde ‘~’) verwendet werden. In der Sprache wird ein Backtick als Akzent (Gravis ) zur Kennzeichnung einer besonderen Aussprache, Betonnung oder Bedeutung eines Buchstaben verwendet. Ein Backtick wird in der Informatik als alleinstehendes Zeichen bezeichnet. Syntaxhighlights mit Backticks beginnen mit drei aufeinanderfolgenden Backticks und enden mit drei aufeinanderfolgenden Backticks. Alle Codezäune können in einem eigenen Shortcode code.html ergänzt werden.

```highlight

	[content]

```

Beispiele für Markdown (*.md)

  | Spalte 1 | Spalte 2 | Spalte 3 |
  |:----:|:--|----:|
  |Zelle 1.1| Zelle 1.2 | Zelle 1.3 |
  |Zelle 2.1| Zelle 2.2 | Zelle 2.3 |
   

  | Spalte 1 | Spalte 2 | Spalte 3 |
  |:----:|:--|----:|
  |Zelle 1.1| Zelle 1.2 | Zelle 1.3 |
  |Zelle 2.1| Zelle 2.2 | Zelle 2.3 |
   

  Text Text Text [^3]
  Text Text Text
  Text Text Text
  Text Text[^2] Text Text 
  Beispiel Literaturangabe[^4]

  [^3]: Fussnote werden automatisch sortiert
  [^2]: Fussnote werden automatisch sortiert
  [^4]: Kleiber: Verkehrswertermittlung von Grundstuecken, 9. Auflage 2020, S. 3091, Teil: VIII, RgNr. 412 
   

Andere Backticksbeispiele

  gpg --import signature_key.asc
  odbc-connect --database exceltable.xls --version --help

  cmake.exe 	--build .\\build	^
		--verbose		^ 
		--clean-first		^
		--config Release 	^
		--target install

50
51
52
53

 int     a=1, b=8;
 int funktion(int x, int y){ 
     return x+y;
 }

 int     a=1, b=8;
 int funktion(int x, int y){ 
     return x+y;
 }

 3
 4
 5
 6
 7
 8
 9
10
11

a <- c(1:7, NA)
mean(a, na.rm = TRUE)

library("dplyr")
df %>%
  mutate(date = lubridate::ymd(date_string)) %>%
  select(- date_string)
str(df)
nrow(df)

a <- c(1:7, NA)
mean(a, na.rm = TRUE)

library("dplyr")
df %>%
  mutate(date = lubridate::ymd(date_string)) %>%
  select(- date_string)
str(df)
nrow(df)

50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

{{ partial "header.html" . }}

  <h1>posts</h1>
  {{ range first 10 .Data.Pages }}
    {{ if eq .Type "post"}}
      <h2><a href="{{ .Permalink }}">{{ .Title }}</a></h2>
    {{ end }}
  {{ end }}

  <h1>pages</h1>
  {{ range .Data.Pages }}
    {{ if or (eq .Type "page") (eq .Type "about") }}
      <h2><a href="{{ .Permalink }}">{{ .Type }} - {{ .Title }} - {{ .RelPermalink }}</a></h2>
    {{ end }}
  {{ end }}

{{ partial "footer.html" . }}

50
51
52
53
54
55
56

package main
import fmt "fmt"

func main() 
{
   fmt.Printf("Hello, World!\n");
}

165
166
167
168
169
170
171

package main
import fmt "fmt"

func main() 
{
   fmt.Printf("Hello, World!\n");
}

package main
import fmt "fmt"

func main() 
{
   fmt.Printf("Hello, World!\n");
}

 #!/bin/bash
 ###### CONFIG
 ACCEPTED_HOSTS="/root/.hag_accepted.conf"
 BE_VERBOSE=false

 if [ "$UID" -ne 0 ]
 then
  echo "Superuser rights required"
  exit 2
 fi

 genApacheConf(){
  echo -e "# Host ${HOME_DIR}$1/$2 :"
 }

50
51
52
53
54
55
56
57
58
59
60
61
62
63

 #!/bin/bash
 ###### CONFIG
 ACCEPTED_HOSTS="/root/.hag_accepted.conf"
 BE_VERBOSE=false

 if [ "$UID" -ne 0 ]
 then
  echo "Superuser rights required"
  exit 2
 fi

 genApacheConf(){
  echo -e "# Host ${HOME_DIR}$1/$2 :"
 }

50
51
52
53
54
55
56
57
58
59
60
61
62
63

 #!/bin/bash
 ###### CONFIG
 ACCEPTED_HOSTS="/root/.hag_accepted.conf"
 BE_VERBOSE=false

 if [ "$UID" -ne 0 ]
 then
  echo "Superuser rights required"
  exit 2
 fi

 genApacheConf(){
  echo -e "# Host ${HOME_DIR}$1/$2 :"
 }

50
51
52
53
54
55
56
57

 Sub Vorlagenordner_Word()
  
  MsgBox _ 
  "Programm    - Application.Path"                         & vbNewLine & Application.Path            & vbNewLine & vbNewLine & _
  "Startordner - Application.StartupPath"                  & vbNewLine & Application.StartupPath     & vbNewLine & vbNewLine & _
  "Vorlagen    - ActiveDocument.AttachedTemplate.FullName" & vbNewLine & ActiveDocument.AttachedTemplate.FullName
 
 End Sub

 @echo off

 set PATH_CODEBLOCKS=C:\dev\codeblocks\codeblocks-current\
 set PATH_USERPROFIL=M:\Projekte\Programmierung\Codeblocks-IDE\profile

 start /D %PATH_CODEBLOCKS% codeblocks.exe --user-data-dir=%PATH_USERPROFIL%

50
51
52
53
54
55
56
57
58
59
60
61
62
63

 function $initHighlight(block, cls) {
   try {
     if (cls.search(/\bno\-highlight\b/) != -1)
       return process(block, true, 0x0F) +
              ` class="${cls}"`;
   } catch (e) {
     /* handle exception */
   }
   for (var i = 0 / 2; i < classes.length; i++) {
     if (checkCondition(classes[i]) === undefined)
       console.log('undefined');
   }
 }
 export  $initHighlight;

Beispiel mit Shortcode {{<highlight>}}

 {{<highlight go-html-template "linenos=table,hl_lines=1 3-6 8,linenostart=199">}}
	[content] 
 {{</highlight>}}

Ergebnis:
Der Parameter hl_lines=1 3-6 8 belegt die Zeilen 1, 3 bis 6 und 8 mit einer anderen Hintergrundfarbe.

199
200
201
202
203
204
205
206

 <section id="main">
   <div>
    <h1 id="title">{{ .Title }}</h1>
     {{ range .Data.Pages }}
         {{ .Render "summary"}}
     {{ end }}
   </div>
 </section>

Beispiel zum anzeigen einer Verzeichnisstruktur

```Shell {linenos=false}

 includes/
  ├── include-page.md
  └── index.md

```

Ergebnis:

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md
   

Weiter Beispiele zum anzeigen von Verzeichnisstrukturen.

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

 .\lib\gcc920TDM_custom
      ├── libwx_baseu-3.1.dll.a
      ├── libwx_mswu_core-3.1.dll.a
      ├── ...
      ├── wxbase314u_gcc_custom.dll
      ├── wxmsw314u_core_gcc_custom.dll
      ├── ...
      ├── // und die Dateien fuer den Debugger ...
      ├── ...
      ├── libwx_baseud-3.1.dll.a
      ├── libwx_mswud_core-3.1.dll.a
      ├── ...
      ├── wxbase314ud_gcc_custom.dll
      ├── wxmsw314ud_core_gcc_custom.dll
      └── ...

 includes/
  ├── include-page.md
  │   └── wx
  │       └── setup.h
  └── index.md

Beispiel Verknüpfungen

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

 \\GIS\akdbprg\w3GIS.kom\w3GIS\client\w3GEOportal.exe http://GIS/w3GEOportal/default.asp?AutoStart=1&OpenAppWindow=0
   

Funktionszeichen deaktivieren (maskieren)

In Markdown (*.md)

Die in Markdowndateien für eine besonderen Formatierung belegten Funktionszeichen (z.B. ## für Überschriften, oder > für Blockquotes) können mit einem Backslash (\) maskiert und somit deaktiviert werden um so das entsprechende Literalzeichen zu generieren.

Um in Markdowndateien Shortcode-Anweisung zu deaktivieren und stattdessen anzuzeigen oder zu kommentieren, verwende die Zeichen:

/‍* … *‍/

oder setze die geschweifte Klammer in Hochkommas

“{{" … ”}}"

In Shortcode oder Templates (*.html)

Gohugo verwendet die geschweifte Klammer in Shortcodes oder in Html-Dateien für Funktionsaufrufe und Variablen. Um die geschweifte Klammer selbst zu maskieren und anzuzeigen nimm folgende Syntax:

 {{"{{"}} .Page.Date {{"}}"}}

Adressen mit hexadezimale Entitätscodierung verstecken

Um dieses Future zu verwenden muss in der Datei config.toml der Schalter unsafe auf true gesetzt werden.

 [markup]
   sefaultMarkdownHandler = "goldmark" 
   [markup.goldmark]
      [markup.goldmark.renderer]
         unsafe = true

Zum Beispiel das Verstecken eines Link’s mit hexadezimaler Entitätscodierung.

 <a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>
  

Ergebnis:

address@example.com

Emojies verwenden

Emojies sind standardisierte Symbole zur Darstellung von Emotionen (bzw. Gefühlen), Objekte, Aktivitäten, Tieren und Natur usw. In Markdown werden Emojies durch Wörter symbolisiert, die mit einem Doppelpunkt am Wortanfang und am Wortende eingegrenzt sind.

Eine umfangreiche Seite bietet Emoji cheat sheet .

 enableEmoji = true

Stichworte (tags)

• dev
• gohugo
• markdown