{"id":8752,"date":"2023-09-23T18:03:03","date_gmt":"2023-09-23T16:03:03","guid":{"rendered":"https:\/\/linux-bibel.at\/?p=8752"},"modified":"2023-09-23T18:03:05","modified_gmt":"2023-09-23T16:03:05","slug":"markdown-die-syntax","status":"publish","type":"post","link":"https:\/\/linux-bibel.at\/index.php\/2023\/09\/23\/markdown-die-syntax\/","title":{"rendered":"Markdown – die Syntax"},"content":{"rendered":"\n

Markdown ist eine sogenannte Auszeichnungssprache – mit einer solchen lassen sich Texte unterschiedlichster Art schnell und einfach erstellen und in andere Formate konvertieren. Auf der Linux<\/a> Bibel finden sich zwar schon einige Editor<\/a>en für diese Sprache – eine umfassende Dokumentation dazu jedoch noch nicht. Als Editor<\/a> nutze ich hier ReText – dieser lässt sich unter auf Debian<\/a> basierenden Linux<\/a>-Distribution<\/a>en ganz einfach über die Paket<\/a>-Verwaltung durch das Paket<\/a> „retext<\/strong>“ installieren.<\/p>\n\n\n\n

Sie teilen den Editor<\/a> über die Schaltfläche „Vorschau<\/strong>“ – nutzen Sie den kleinen Pfeil rechts daneben, um die Live-Vorschau zu aktivieren:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Die Markdown-Syntax<\/h3>\n\n\n\n

Die Syntax von Markdown ist sehr einfach gehalten – man soll mit möglichst wenigen Tasten und vor allem mit möglichst wenigen bis keinen Klicks zu einem anspruchsvollen Ergebnis kommen. Beginnen wir einmal:<\/p>\n\n\n\n

# \u00dcberschrift 1\n## \u00dcberschrift 2\n### \u00dcberschrift 3\n#### \u00dcberschrift 4\n##### \u00dcberschrift 5\n###### \u00dcberschrift 6<\/code><\/pre>\n\n\n\n
Sehen wir uns die ganze Geschichte im Editor<\/a> an:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Gehen wir gleich einmal weiter, wir erstellen kursiven Text:<\/p>\n\n\n\n
Dieser *Text ist schr\u00e4g mit Asterisks* geschrieben.<\/code><\/pre>\n\n\n\n
Oder:<\/p>\n\n\n\n
Dieser _Text ist schr\u00e4g, mit Unterstrichen_ geschrieben.<\/code><\/pre>\n\n\n\n
Dieser **Text ist wiederum fett mit Asterisks** geschrieben.<\/code><\/pre>\n\n\n\n
Dieser __Text ist wiederum fett mit Unterstrichen__ geschrieben.<\/code><\/pre>\n\n\n\n
Nutzt man nur die zwei größten Überschriften, lässt sich dies auch mit Unterstrichen regeln:<\/p>\n\n\n\n
\u00dcberschrift 1\n=========<\/code><\/pre>\n\n\n\n
\u00dcberschrift 2\n-----------------<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Jetzt erstellen wir einen Link:<\/p>\n\n\n\n
[Linux Bibel \u00d6sterreich](https:\/\/linux-bibel-oesterreich.at)<\/code><\/pre>\n\n\n\n
Absätze erstellen wir ganz einfach durch eine Leerzeile. Auch Tasten lassen sich sehr einfach darstellen:<\/p>\n\n\n\n
Taste `<Tab>` und die `<Leertaste>`.<\/code><\/pre>\n\n\n\n
Einen Zeilenumbruch erstellen Sie, indem Sie zwei Leerzeichen erstellen und anschließend Eingabe<\/kbd><\/strong> drücken. Linien erstellen Sie so:<\/p>\n\n\n\n
-----\n_____\n*****<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Jetzt erstellen wir Blöcke:<\/p>\n\n\n\n
> Ein erster Block in Markdown.\n>> Und ein tiefer gesetzter Block in Markdown.<\/code><\/pre>\n\n\n\n
E-Mail-Adressen lassen sich ganz einfach einfügen:<\/p>\n\n\n\n
<mail-adresse@gmail.com><\/code><\/pre>\n\n\n\n
Jetzt fügen wir ein Bild ein:<\/p>\n\n\n\n
![Ein Bild](\/home\/robertg\/Downloads\/markdownx.jpg)<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Gehen wir weiter mit Listen:<\/p>\n\n\n\n
1. Erster Punkt\n2. Zweiter Punkt\n3. Dritter Punkt<\/code><\/pre>\n\n\n\n
Listen ohne Ordnung:<\/p>\n\n\n\n
+ Erster Punkt\n+ Zweiter Punkt\n+ Dritter Punkt<\/code><\/pre>\n\n\n\n
Oder geordnete Listen:<\/p>\n\n\n\n
1. Erster Punkt\n       1. Erster Unterpunkt\n       2. Zweiter Unterpunkt\n2. Zweiter Punkt\n3. Dritter Punkt<\/code><\/pre>\n\n\n\n
Oder eben:<\/p>\n\n\n\n
+ Erster Punkt\n      + Erster Unterpunkt\n      + Zweiter Unterpunkt\n+ Zweiter Punkt\n+ Dritter Punkt<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Ein Code-Block:<\/p>\n\n\n\n
`apt install retext`<\/code><\/pre>\n
\r\n    
\r\n    \r\n                            \"Gef\u00e4llt\r\n            <\/a>\r\n        <\/span>\r\n<\/div>
\r\n    \r\n                            \"Gef\u00e4llt\r\n            <\/a>\r\n    <\/span>\r\n<\/div><\/div>","protected":false},"excerpt":{"rendered":"
Markdown ist eine sogenannte Auszeichnungssprache – mit einer solchen lassen sich Texte unterschiedlichster Art schnell und einfach erstellen und in andere Formate konvertieren. Auf der Linux Bibel finden sich zwar schon einige Editoren f\u00fcr diese Sprache – eine umfassende Dokumentation dazu jedoch noch nicht. Als Editor nutze ich hier ReText – dieser l\u00e4sst sich unter […]<\/p>\n","protected":false},"author":1,"featured_media":8757,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[57],"tags":[59],"class_list":["post-8752","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-buero","tag-buero"],"_links":{"self":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts\/8752","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/comments?post=8752"}],"version-history":[{"count":1,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts\/8752\/revisions"}],"predecessor-version":[{"id":8759,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/posts\/8752\/revisions\/8759"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/media\/8757"}],"wp:attachment":[{"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/media?parent=8752"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/categories?post=8752"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/linux-bibel.at\/index.php\/wp-json\/wp\/v2\/tags?post=8752"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}