Markdown in Jupyter Notebook Tutorial
Markdown ist eine leichtgewichtige und beliebte Markup-Sprache, die ein Schreibstandard für Datenwissenschaftler und Analysten ist. Oft wird es mit dem Markdown-Prozessor in das entsprechende HTML-Format umgewandelt, so dass es leicht zwischen verschiedenen Geräten und Personen ausgetauscht werden kann.
Die Auszeichnungssprache ähnelt der Hypertext Markup Language (HTML) und besteht aus dem öffnenden Tag <tagname> und dem schließenden Tag </tagname>.
In diesem Tutorial kannst du das gleiche Ergebnis sehen, wenn du Markup-Tags verwendest und auch die Markdown-Syntax, die von Jupyter Notebook unterstützt wird.
Du brauchst Jupyter Notebook, die Umgebung kannst du mit dem DataCamp-Tutorial einrichten: Jupyter Notebook Tutorial: Der endgültige Leitfaden.
Markdown-Zellen können in Jupyter Notebook über das Dropdown-Menü oder auch über die Tastenkombination "m/M" direkt nach dem Einfügen einer neuen Zelle ausgewählt werden.
Python kostenlos lernen
Einführung in Funktionen in Python
Führe den Code aus diesem Tutorial online aus und bearbeite ihn
Code ausführenÜberschriften
Die Überschriften beginnen mit "#", d.h. einem Rautensymbol, gefolgt von einem Leerzeichen, und es gibt sechs Überschriften, wobei die größte Überschrift nur ein Rautensymbol und die kleinste Überschrift sechs Rautensymbole verwendet.
# (Kopfzeile 1, Titel)
## (Überschrift 2, Hauptüberschriften)
### (Überschrift 3, Zwischenüberschriften)
#### (Header 4)
##### (Header 5)
###### (Header 6)``
Alternativ können die Überschriften mit Markup Tags beginnen, d.h. von h1 bis h6 mit den folgenden Syntaxen.
<h1>Überschrift 1,Titel<h1>
<h2>Überschrift 2,Hauptüberschriften<h2>
<h3>Überschrift 3,Zwischenüberschriften<h3>
<h4>Kopfzeile 4<h4>
<h5>Kopfzeile 5<h5>
<h6>Kopfzeile 6<h6>
Beide oben genannten Syntaxen können die Überschriften von h1 bis h6 darstellen, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Blockquotes
Blockzitate können einen großen Textabschnitt enthalten und sind in der Regel eingerückt. Sie können mit dem Markdown-Symbol '>' oder mit <blockquote>text für blockquote</blockquote> erhalten werden.
- >Das ist gut
- <blockquote>Das ist gut</blockquote>
Beide oben genannten Syntaxen können den Text in eingerückter Form darstellen, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Code Abschnitt
Der Code-Abschnitt ist der Teil, der den Code verschiedener Programmiersprachen angibt und kann so dargestellt werden, dass Inline-Code mit ' `Inline-Code geht hier hin` ' Back-Ticks um ihn herum beginnt, aber der Code-Block mit drei Back-Ticks ' ```Blockzeilen-Code geht hier hin`` ' beginnt. Das Markup-Tag für einen Code-Abschnitt lautet "<code>Code kommt hier hin<code>".
Das Inline-Code-Beispiel ist unten angegeben:
`x =5`
Wie du siehst, wird der Inline-Code nach dem Klicken auf "Ausführen" gerendert und hervorgehoben.
Im Folgenden findest du Beispiele für Codeabschnitte:
- Markdown verwenden ```Python
- str = "Dies ist ein Code auf Blockebene"
- print(str)
- Markup-Tags verwenden <code>Python
- ```
- str = "Dies ist ein Code auf Blockebene"
- print(str)
- </code>
Mit Markdown kannst du die Syntaxhervorhebung des Codes erhalten, wenn der Name der Programmiersprache nach den drei Häkchen "```" genannt wird, wie das folgende Beispiel zeigt:
In Markdown bekommst du keine Syntaxhervorhebung, aber der Code wird hervorgehoben:
Mathematisches Symbol
Das mathematische Symbol in Markdown ist in '\$ mathematischer Ausdruck geht hier \$' in einem Dollar-Symbol eingeschlossen und in Markup kannst du diesem Link für weitere Details folgen: Mathematische Operatoren. Unten siehst du ein Beispiel für die Verwendung der mathematischen Symbole.
\$\sqrt{k}$
Im obigen Beispiel wird der mathematische Ausdruck in einem fetten Format dargestellt.
Zeilenumbruch
Das Zeilenumbruch-Tag beginnt mit dem <br>-Tag ohne schließendes Tag, das die Zeile umbricht, und der restliche Inhalt beginnt mit einer neuen Zeile, wie im folgenden Beispiel gezeigt.
The line breaks after using <br> br tags and it is awesome.
Nachdem du in der Symbolleiste auf "Ausführen" geklickt hast, kannst du den Zeilenumbruch nach der Verwendung des <br>-Tags sehen. Der restliche Text beginnt in einer neuen Zeile.
Fett und kursiv gedruckter Text
Du kannst <b>-Tags, '**', d.h. 'Doppelsterne' oder '__', d.h. 'Doppelunterstriche' verwenden, um fetten Text mit der folgenden Syntax zu erhalten.
- <b>Dies ist fetter Text</b>
- ** Dies ist fetter Text
- Dies ist fetter Text
Alle oben genannten Syntaxen können fetten Text darstellen, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Du kannst <i>-Tags, '*', d.h. einen einzelnen Stern, oder '_', d.h. einen einzelnen Unterstrich, verwenden, um den Text in der folgenden Syntax kursiv zu machen.
- <i>Dies ist kursiver Text</i>
- * Dies ist kursiver Text
- _ Dies ist kursiver Text
Alle oben genannten Syntaxen können den kursiven Text darstellen, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Horizontale Linie
Du kannst eine horizontale Linie erhalten, indem du in Markdown '---' drei Bindestriche oder die Markup-Tags <hr>
Bei beiden obigen Syntaxen wird die horizontale Linie von einem Ende zum anderen Ende übertragen, nachdem du auf "Ausführen" geklickt hast.
Bestellte Liste
Die geordnete Liste ist eine nummerierte Liste, die man erhält, indem man mit dem <ol>-Tag beginnt und mit dem </ol>-Tag endet und das gewünschte Element zwischen die <li>- und </li>-Tags setzt. Das Tag, also "ol", ist die Kurzform für eine geordnete Liste und "li" ist die Kurzform für das Listenelement. Unten siehst du zum Beispiel die Bestellliste, die den Artikel für die Lebensmittelliste enthält.
<ol>
<li>Fisch</li>
<li>Eier</li>
<li>Käse</li>
</ol>
Alternativ kannst du auch eine 1 angeben, d.h. die gewünschte Zahl gefolgt von einem Leerzeichen, wie im folgenden Beispiel.
- Fisch
- Eier
- Käse
Beide der oben genannten Syntaxen können die nummerierte Liste wiedergeben, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Ungeordnete Liste
Die ungeordnete Liste ist eine Aufzählung, die mit dem <ul>-Tag erstellt wird und mit dem </ul>-Tag endet, siehe das folgende Beispiel:
<ul>
<li>Fisch</li>
<li>Eier</li>
<li>Käse</li>
</ul>
Alternativ kann die ungeordnete Liste auch mit dem Symbol '-' mit Leerzeichen beginnen, was das schwarze Kreissymbol ergibt, und sie kann auch mit dem Symbol '*' mit Leerzeichen beginnen, was das schwarze Quadratsymbol ergibt.
- Fisch
- Eier
- Käse
Das obige Beispiel zeigt, dass die Aufzählungsliste das Symbol "-" enthält, gefolgt von einem Leerzeichen mit den Elementen, die das schwarze Kreissymbol ergeben.
Beide oben genannten Syntaxen können zu demselben Ergebnis führen, bei dem die Elemente in der Liste im schwarzen Kreis erscheinen, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Interner und externer Link
Ein interner Link in Markdown beginnt mit einem <a>-Tag mit einer eindeutigen ID, die durch das Attribut "id" definiert wird und mit dem folgenden Beispiel im Notizbuch verlinkt werden kann:
<a id = "division_ID"text goes here></a>
Außerdem kann die oben definierte ID mit dem Abschnitt des Notizbuchs verknüpft werden, indem du dem Code folgst, der den Link anklickbar macht.
[Section title](#division_ID)
Unten siehst du ein Beispiel, bei dem die definierte ID mit dem Abschnitt und dem klickbaren Link verknüpft ist, den du erhältst, wenn du in der Symbolleiste auf "Ausführen" klickst.
Externe Links in Markdown beginnen mit dem <a>-Tag und enden mit dem <a>-Tag, d.h. <a> steht für den Anker, der den Link definiert, und er hat das Attribut "href", auch Hyperreferenz genannt, das die Zieladresse des Links oder die URL enthält, und der Text zwischen den Tags ist sichtbar und kann angeklickt werden, um die Zieladresse zu öffnen (siehe unten).
<a> href="https://www.google.com" >Link to Google</a>
Alternativ könnte er auch mit __[Textlink](URL für die Website)__ beginnen, wobei der doppelte Unterstrich auf beiden Seiten steht, der Textlink in einer eckigen Klammer und die URL für die Website in einer Klammer, gefolgt von der URL, steht.
Beide obigen Syntaxen können das gleiche Ergebnis liefern, wobei der anklickbare und unterstrichene Text zu einer neuen Seite führen kann, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Tabelle
Die Tabelle enthält die Informationen in Zeilen und Spalten und wird durch die Kombination von "|", d.h. "vertikale Pipe", um jede Spalte zu trennen, und "-", d.h. das Bindestrichsymbol, um die Kopfzeile zu erstellen, wobei die Leerzeile, d.h. eine Kombination aus vertikaler Pipe und Bindestrichen, das Tabellenformat wiedergibt.
Außerdem kannst du die Zellen variieren, indem du sie grob an den Spalten ausrichtest, und das Notizbuch passt die Größe des Inhalts in der jeweiligen Zelle automatisch an.
|Name|Address|Salary|
|-----|-------|------|
|Hanna|Brisbane|4000|
|Adam|Sydney|5000|
Alternativ kann Markdown verwendet werden, um Tabellen zu erstellen, wobei < table > verwendet wird, um eine Tabelle mit ihrer Breite in Prozent zu definieren. <tr> setzt die Tabellenzeile, die den fettgedruckten und zentrierten Text zusammen mit der Tabellenüberschrift enthält, die durch <th> am oberen Rand der Tabelle beschrieben wird, während die anderen Einträge in der Tabelle durch das <td>, d.h. das Tabellendaten-Tag, festgelegt werden.
<table style="width:20%">
<tr>
<th><Name></th>
<th><Adresse></th>
<th><Gehalt></th>
</tr>
<tr>
<td><Hanna></td>
<td><Brisbane></td>
<td><4000></td>
</tr>
<tr>
<td><Adam></td>
<td><Sydney></td>
<td><5000></td>
</tr>
</table>
Beide oben genannten Syntaxen können zu demselben Ergebnis führen, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Bilder
Du kannst ein Bild aus der Symbolleiste einfügen, indem du "Bild einfügen" aus dem Menü "Bearbeiten" wählst und das gewünschte Bild wie unten gezeigt durchsuchst.
Das Bild kann den Markdown-Tag <img> mit dem Attribut source, d.h. src, enthalten, der den Link zum Bild mit optionalen Eigenschaften wie Breite und Höhe enthält (siehe Beispiel unten).
<img> <src="https://i.imgur.com/WWrydEh.png" width ="500" height=500 >
Beide oben genannten Prozesse können das gleiche Bild rendern, nachdem du in der Symbolleiste auf "Ausführen" geklickt hast.
Fazit
In diesem Tutorial hast du verschiedene Markup-Tags kennengelernt, die von der Markup-Sprache definiert werden, sowie die Syntax der Markdown-Zellen, die speziell für das Jupyter Notebook verwendet werden, um den Inhalt effektiver zu beschreiben.
Wenn du mehr über Markdown erfahren möchtest, wirf einen Blick in den Markdown Guide.
Python-Kurse
Course
Einführung in Python
Course
Funktionen in Python schreiben
Course