# Markdown-Syntax #

<style>
	h2 {color:hsl(33,100%,50%)}

	em {color:brown}
	strong {color:green}
</style>

aus [https://markdown.de](https://markdown.de), siehe auch hier

* [https://www.ionos.de/digitalguide/websites/web-entwicklung/markdown/](https://www.ionos.de/digitalguide/websites/web-entwicklung/markdown/)
* [http://markdown-syntax.de/Was-ist-Markdown/](http://markdown-syntax.de/Was-ist-Markdown/)

<a name="html"></a>
## HTML


Man kann auch HTML ins Markdown[^1] schreiben, jedoch funktioniert die Markdown-Syntax NUR außerhalb des HTML-Blocks

[^1]: Fußnote. Am Besten unter dem Absatz als Absatz (Leerzeile drüber und drunter)

Konvertiere online HTML zu Markdown:
[browserling.com](https://www.browserling.com/tools/html-to-markdown)

<div>
	<p><span style="">**sollte eigentlich betonter Text sein**</span> ist aber nicht, weil im HTML-Block.</p>

	<p>Im HTML <span style="color:red">nur</span> HTML, <span style="color:red">kein Markdown</span></p>
</div>

### Kommentare

Als Kommentar fungiert die Kommentar-Syntax vom HTML
<pre>&lt;!-- ein Kommentar --&gt;</pre>

[comment]: # (Kommentarinhalt)

## Zitate, Listen, Fußnoten, Tabellen

> Zitat
>> Zitat im Zitat


* Ungeordnete Liste
	* (nach Tab) Ungeordnete Liste
		* Ungeordnete Liste


1. geordneter Listenpunkt
1. geordneter Listenpunkt
1. geordneter Listenpunkt
1. geordneter Listenpunkt
1. geordneter Listenpunkt


4. geordneter Listenpunkt

erst wieder Text dazwischen, dann neue Liste

5. geordneter Listenpunkt
6. geordneter Listenpunkt


Nummerierte Listen, die mit einer beliebigen Zahl beginnen sollen, können nur mit HTML geschrieben werden z. B. &lt;ol start="4"&gt; &lt;li&gt;

**Automatische Listenformatierung** z. Bsp. bei:

1986\. Was für ein wundervolles Jahr... **unterbindet man mit einem Backslash** vor dem Punkt.

Markdown gibt Ihnen die Möglichkeit, Fußnoten[^Fussnote] zu setzen. In den Fließtext schreiben Sie eine Anmerkungsziffer und lösen diese am Ende der Seite in der Fußnote auf – eine entsprechende Linie wird dabei automatisch erzeugt. Die Anmerkungsziffer ist zudem als Hyperlink formatiert. Also

Link: \[^Fussnote\] mit der Definition, am Besten, unter dem Absatz:
\[^Fussnote\]: Text

oder Link: \[^56\] mit der Definition unter Absatz:
\[^56\]: Text

[^Fussnote]: Welche Nummer (auch andere Begriffe sind möglich) Sie einsetzen, ist unerheblich. Die Fußnoten werden, unabhängig von ihrer Bezeichnung automatisch hochnummeriert.


<style>
	th {background-color:hsl(33,100%,90%)}
</style>

Column | Column | Column
:---   | :----: | -----------:
:Left   | :Center: | Right:
3 --- mind.  | align  | align



## Links

### Anker setzen

zur Überschrift HTML [hier](#toc_1). Überschriften bekommen fortlaufende id-Kennungen im Format `id="toc_lfd"`, beginnend mit toc_0. Um einen Anker anzusprechen, muß man die id-Kennung (mit Nr) kennen und, wenn der Abschnitt mit dieser Überschrift an andere Stelle verschoben wird, den Link händisch ändern.

Deshalb ist es sicherer, wenn man den Anker mit HTML-Syntax setzt: `<a name="html"></a>`
und mit der Syntax [ `[HTML](#html)` ](#html) dorthin gelangt


### Link-Definitionen (nicht sichtbar)

sollten am Anfang der Datei stehen, auf jedem Fall über dem ersten Aufruf.

[foo1]: http://example.com/  "Optionaler Titel 1"

[foo2]: http://example.com/  'Optionaler Titel 2'

foo2 funktioniert nicht immer wegen Markdown-Bug (siehe Quelltext)

[id1]: <http://example.com/>  "Optionaler Titel hier id1"

#### so funktionierts

* [Link-Text][foo1]
* ganz verrückt, Link nur nach Nennung der (obigen) Kennung
* [helm.berlin][] - aus Definition ganz unten
* und ganz normal, einmalig: [Text zum Anklicken](https://Linkadresse.com/ "Titletext")

* Ich bekomme zehn Mal mehr Traffic von [Google] [1] als von
[Yahoo] [2] oder [MSN] [3]. Die Links werden am Ende des Dokuments definiert[^25].

[^25]: [Helm-Tools] [4] (vordefiniert) in der Fußnote funktioniert nicht z. B. in Notes-Up, aber als [Helm-Tools-Komplettlink](https://tools.helm.berlin) geht er


## Layout

weicher Zeilenumbruch,  
kein neuer Absatz, sondern ein \<br\> geht so: setze 2 Leerzeichen, z. B. hier  
ans Ende der Zeile und drücke Enter

*\*Einzelne Sternchen = em\**

_\_Einzelne Unterstriche = auch em\__

**\**fetter Text mit zwei Sternchen =strong\*\*** oder
__\__mit zwei Unterstrichen =strong\_\___

***fett und kursiv*** (**&lt;strong&gt;***&lt;em&gt;im HTML&lt;/em&gt;***&lt;/strong&gt;**) mit DREI Sternchen oder DREI Unterstrichen

~~Durchgestrichen mit doppelten Tilden~~ oder <s> Durchgestrichen mit</s> &lt; s &gt; –Tag


**Farben** können nur über HTML+CSS eingefügt werden.


### Grafiken

![Apple-Logo](/Volumes/DatenHD/willy/Documents/mamp/tools/apple_logo26.gif "title = Apple-Logo") einmalig eingefügt


[applelogo]: apple_logo26.gif "Apple-Logo aus Dateipfad"


* ![applelogo][] - aus Definition oben, öfters mit Abkürzung verwendbar
* ![applelogo64][] - noch eins, wurde nur einmal definiert
* ![applelogo][] - noch eins
* ![applelogo64][] - noch eins


### Horizontale Linien

***

---

- - - - - -

------

### Code und Kommentare
	Zeile einfach einrücken mit Tab
	[comment]: # (Kommentarinhalt)
	- oder mit 3 ``` wie folgend

```html
<html>
  <head>
  </head>
</html>
```
```js
document.write('schreibt Text ins Dokument');
```
```css
/* Farbe (0-359), Sättigung, Helligkeit */
body{color:hsl(200,50%,60%)}
```

auch mit `code` (in HTML = &lt;code&gt;code&lt;/code&gt;) im laufenden Text ooder mit dem `<pre>`-Tag (geschriebenes &lt;pre&gt;), wie folgt:
<pre>
Markdown-Kommentar (sollte dargestellt werden):
\[comment\]: # (Komentarinhalt)
HTML-Kommentar (sollte hier ausgegeben werden):
&lt;!-- ein Kommentar funktioniert auch überall --&gt;
</pre>

\[comment\]: **# (**Kommentar nur nach Leerzeile und eingeklammert**)**

[comment]: # (Ein Beispielkommentar, welcher unsichtbar sein müßte, aber z. B. von Marktext angezeigt wird)

Am Besten ist wohl, mit den HTML-Kommentaren zu arbeiten.

## Backslash-Maskierung

	\   Backslash
	`   Backtick
	*   Sternchen
	_   Unterstrich
	{}  Geschweifte Klammern
	[]  Eckige Klammern
	()  Runde Klammern
	#   Raute
	+   Plus-Zeichen
	-   Minus-Zeichen (Bindestrich)
	.   Punkt
	!   Ausrufezeichen


[applelogo64]: data:image/gif;base64,R0lGODlhGgAaAPcAMf//////wef/wd7/xNb/v8v/wNf5vfPww//ex8Lh///RwP/H3vXA0P//wf/5uuf/wdb/v/X1t8v/wNf5vcf/tc74ucT3tf/fusfvs//RwLzW+//CxPjB1LbL/7PM9P//sf/5uv/ysMf/tc74ucT4rsT3tcfvs8Ttq//StbbL/7PM9P+8sarE6fmuxau/9Oyuvf//sf/3pv/ysMT4rsLxocTtq6/qn7znn6bnk/jAp5vghf+8savH+arE6au/9Oyuvf+pquektf/3psLxobznn63fmqbgjJvghfjAp5PdeqvH+au/9P+pquektZe155i08+eclv71mKbnk63fmqbgjJvghZPdevu0mITXaO+ylovRdIDNaJi085e15/+ZmZKy2eecsZiu6Oeclv/vk/7ii5vghZPdeoTXaIvRdIDNaJe155Ws8u6Tjo2n5IOl4tyMp//vk/7oc4DNaHTNV3zEZGrHVHPBV/eNgGm8VYOl4tyMp36d4n6a19CDl+arf3TNV2rHVHPBV2jESWm8VfeNgGW5SeyKfdR8lXKS3s18j2uMzv3iXWjESWW5SeyKfVq6Qn6a1+GFeGuMztlta1+CyV6B1v3iXWjESfmLZlq6Qk+2Ne11ZMVvitlta1+CyV6B1sVngk95x/rcTvmLZlq6Qk+2NU2tMUWvKcVnguBfY095x7hcdU5zwkxyyffaRE2tMet6WEWvKUWqIzipH+BfY8pcXbhcdU5zwtlVUcJVekFrvUWqIzipHzSnGjqkGC+iENlVUUhrrUFrvTdkuqxHbjJbtqM9av7ufffhXvrcTvfaRPnWNfnQLOGCUtF/TUWqI+V0SDipHzSnGjqkGPhqHC+iEOVlSvdjISmfCexgQd5jQu5hJSOeASucAeBfKNlVUdxLRshKTdxCRDdkustBPt45NTJbttgzOqM9aipYtcwzMzVWm98rNihTtCNSstooKiZQrZkzZscpJtQgIZIrV40oZH4obXQqcssZFowhXIIiaH4jaYogYIQhZMYSEr0PDiH5BAEAAAAALAAAAAAaABoAAAiSAAEIHEiwIAAJBhMqHMiN28KHBBs6hPhQ4kSKCiViXIit4caBpSReimgRosWTKC8aTMlSo0FmMGPKnBlTIc2bMm3i3KmQms+fQIP+7Cm0KFCiRo0iTSpU4bx/UKNKnRpVIdWrU8klxMq1akF9YMOKHTs2IdmzZc2iXbvQndu3cOO6gyi3rrtxFOMOhIvoo18AAQEAOw== "Apple-Logo Base 64"

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/   "MSN Search"
[4]: https://tools.helm.berlin "Meine Tools"
[helm.berlin]: http://tools.helm.berlin/  (Tools)


