Kleinkram über Markdown, den ich immer vergesse und googeln muss

Avatar of Chris Coyier
Chris Coyier am

DigitalOcean bietet Cloud-Produkte für jede Phase Ihrer Reise. Starten Sie mit 200 $ kostenlosem Guthaben!

Das ist hauptsächlich für mich. Das sind die kleinen Dinge, die mich manchmal über Markdown verwirren und wofür ich das Web durchsuchen muss. Also schreibe ich sie auf. Bloggen als Gedächtniserweiterung.

Beachten Sie, dass Ihre Erfahrungen mit diesen Dingen variieren können, da es viele Varianten von Markdown gibt.

markdown=”1″

Es gibt kein Konzept eines <div> in der Markdown-Syntax (oder in den meisten anderen strukturellen HTML-Elementen), außer dass Markdown HTML unterstützt, sodass Sie einfach ein <div> verwenden können, wenn Sie möchten. Aber sobald Sie das tun, kann nichts darin verschachtelt sein, was Markdown ist.

### Header

<div class="special-class">
1. Nope
1. Not 
1. Happening
</div>

Außer doch! In vielen (den meisten?) Varianten von Markdown können Sie <div markdown="1"> in das Element schreiben und es wird Markdown darin zulassen.

### Header

<div class="special-class" markdown="1">
1. All
1. Fixed 
1. Up
</div>

Listen mit mehreren Absätzen und Blockquotes

Wenn ein Listenelement mehrere Absätze enthalten muss, können Sie nicht einfach mehrere Zeilen umbrechen und weitermachen. Der nächste Absatz muss eingerückt sein, damit er als Teil desselben Listenelements betrachtet wird. Andernfalls endet die Liste und eine neue beginnt.

1. one paragraph

    more for 1st list item :)

1. another paragraph

Blockquotes sind ähnlich

> First bit.
> Second bit.

Dort wird kein Zeilenumbruch sein. Diese beiden Teile werden sich innerhalb desselben <p> innerhalb des <blockquote> befinden. Um daraus mehrere Absätze zu machen, benötigen Sie eine Leerzeile dazwischen.

> First bit.

> Second bit.

Wenn Sie daraus vollständig getrennte <blockquote>s machen wollten, ohne weiteren Text dazwischen, bin ich mir nicht sicher, was Sie tun würden.

Zeichen maskieren

Bestimmte Zeichen haben in Markdown eine Bedeutung, wie zum Beispiel, dass *Sterne* Text kursiv machen. Aber was, wenn Sie tatsächlich einen Stern anzeigen möchten? Sie maskieren ihn mit einem Backslash, wie \*.

Sie können sogar den Backslash selbst maskieren, was bedeutet, dass \\ ein \ ist.

IDs

Markdown unterstützt HTML, also wenn Sie spezielle Attribute für Elemente benötigen, können Sie einfach HTML verwenden. Aber es ist schön, wenn man es nicht tun muss.

Verschiedene Markdown-Varianten handhaben dies auf unterschiedliche Weise.

Eine einigermaßen gängige Methode ist, sie auf Überschriften wie diese zu erlauben

### Custom IDs {#custom-id}

Einige Varianten fügen einfach automatisch eine ID zu allen Überschriften hinzu.

Das ist auch clientseitig machbar.

Bilder

Es ist dasselbe wie die Link-Syntax [Link-Text](URL), nur dass es mit einem Ausrufezeichen beginnt.

![alt text](http://example.com/image.jpg)

Noch etwas kniffliger ist es, es zu einem Link zu verschachteln

[![alt text](image.jpg)](https://css-tricks.de)

Sprachen bei Code-Fences

Die Sprache kommt direkt nach der ersten Klammer.

```css
body {
  background: red;
}
```

Tabellen

Sie zeichnen sie im Grunde wie ASCII-Art. Beachten Sie die Striche, die die Kopfzeile kennzeichnen, und die Doppelpunkte für die Ausrichtung.

| header | header | header |
|--------|:------:|-------:|
| a      |    b   |      c |
| 1      |    2   |      3 |
| foo    |   bar  |    baz |

Ich bin wohl nicht allein

Hier ist ein ganzer Thread darüber, was andere Leute vergessen.