Texte schreiben mit Markdown

--- title: Texte schreiben mit Markdown tags: markdown, talk, workshop description: Eine Einführung in Markdown für Geisteswissenschaftler im WiSe 2020 author: Adrian Pachzelt --- <style> .reveal h3 {font-size: 1.1em} </style> # Spielregeln * Eigenes Mikrofon: **AUS** * Eigenes Video: **AN** oder **AUS** * Buttons: ![](https://i.imgur.com/iL2X4hs.png) * Fragen nur im Chat --- # Texte schreiben in Markdown Adrian Pachzelt --- ## Das bin ich - Full-Stack-Entwickler/Data Engineer an der UB Frankfurt - Entwicklung einer semantischen Suche im [BIOfid](https://www.biofid.de)-Projekt - Automatisierung von Routineaufgaben - Streiter für Maschinenlesbarkeit - Tabletop-Rollenspiel-Nerd :sparkling_heart: `@GrazingScientist` --- ## Es war einmal in einem Text-Editor... ``` Das ist eine Überschrift Hier steht dann ein paar Worte Es folgt eine Unterüberschrift Vielleicht auch eine Aufzählung Links können auch eingefügt werden (https://www.website.de) ``` --- ## Es war einmal in einem Text-Editor... ``` # Das ist eine Überschrift Hier steht dann ein paar Worte ## Es folgt eine Unterüberschrift * Vielleicht * auch * eine * Aufzählung [Links können auch eingefügt werden](https://www.website.de) ``` --- ## Wozu Markdown? :arrow_right: **Beispiel**: `docx-Dokument` ----  ### Ein Beispiel aus dem "echten" Word <w:body><w:p><w:pPr><w:pStyle w:val="Title"/><w:bidi w:val="0"/><w:spacing w:before="240" w:after="120"/><w:jc w:val="center"/><w:rPr></w:rPr></w:pPr><w:r><w:rPr></w:rPr><w:t>Mein großartiges Paper, das in Nature oder wenigstens in PNAS veröffentlicht wird</w:t></w:r></w:p><w:p><w:pPr><w:pStyle w:val="Heading2"/><w:bidi w:val="0"/><w:jc w:val="left"/><w:rPr></w:rPr></w:pPr><w:r><w:rPr></w:rPr><w:t>Zusammenfassung</w:t></w:r></w:p><w:p><w:pPr><w:pStyle w:val="TextBody"/><w:bidi w:val="0"/><w:jc w:val="left"/><w:rPr></w:rPr></w:pPr><w:r><w:rPr></w:rPr><w:t>Lorem ipsum dolor sit amet, consetetur sadipscing... ---- ### Das gleiche in Markdown (nur Text) ``` # Zusammenfassung Lorem ipsum dolor sit amet, consetetur .... # Einleitung Lorem ipsum dolor sit amet, ... ``` ---- ### Das gleiche in Markdown (mit Metadaten) ``` --- title: Mein großartiges Paper, das in Nature oder wenigstens in PNAS veröffentlicht wird author: Adrian Pachzelt --- # Zusammenfassung Lorem ipsum dolor sit amet, consetetur .... # Einleitung Lorem ipsum dolor sit amet, ... ``` ---- ### Vorteile des Markdown-Formats * Einsteigerfreundlicher Kompromiss zwischen Style und Komfort * Teilen einer großen Datei in viele kleine * Versionierbarkeit * Archivierbarkeit * Maschinenlesbarkeit ---- ### Einsteigerfreundlichkeit ``` Das ist eine Überschrift Hier steht dann ein paar Worte Es folgt eine Unterüberschrift Vielleicht auch eine Aufzählung Links können auch eingefügt werden (https://www.website.de) ``` ---- ### Einsteigerfreundlichkeit ```mediawiki # Das ist eine Überschrift Hier steht dann ein paar Worte ## Es folgt eine Unterüberschrift * Vielleicht * auch * eine * Aufzählung [Links können auch eingefügt werden](https://www.website.de) ``` **Markdown** ---- ### Einsteigerfreundlichkeit ``` \section{Das ist eine Überschrift} \label{sec:ueberschrift} Hier steht dann ein paar Worte \subsection{Es folgt eine Unterüberschrift} \label{subsec:ueberschrift} \begin{itemize} \item Vielleicht \item auch \item eine \item Aufzählung \end{itemize} \href{https://www.website.de}{Links können auch eingefügt werden} ``` **LateX** ---- ### Versionierbarkeit **1. Version** `Kant beschrieb 1900 den kategorischen Imperativ, der davon ausgeht, dass...`  **Änderung** `Kant hat ab 1900 'ne Menge Zeug geschrieben, unter anderem...` --- ### Archivierbarkeit Texte lassen sich auch in 20 Jahren noch mit einem Texteditor lesen. ---- ### Machinenlesbarkeit Wiss. Veröffentlichungen werden heutzutage in Massen von Wissenschaftler\*innen mittels Skripten eingelesen und analysiert. ---- > Markdown?! Hab davon noch nie gehört! Wer benutzt denn sowas? > --- Anonyme\*r Student\*in ---- ## Markdown wird von vielen Anwendungen benutzt * Facebook Messenger * Discord * Skype * Slack * WhatsApp * Wikipedia ---- ## Online Markdown-Editoren * [StackEdit](https://stackedit.io) * [HackMD](https://hackmd.io/) Erlauben kollaboratives Schreiben ---- ## Desktop-Markdown Editoren * [Zettler](https://www.zettlr.com/) * [Atom IDE](https://ide.atom.io/) + Plugin [Mardown-Preview-Enhanced](https://atom.io/packages/markdown-preview-enhanced) --- ## Was passiert im Hintergrund? Umwandlung von Markdown in HTML ```mediawiki # Von den grünen Auen vor Frankfurt Als ich mich dem bezaubernden Tore ... ```  :arrow_down_small: ```htmlembedded <h1>Von den grünen Auen vor Frankfurt</h1> Als ich mich dem bezaubernden Tore ... ```  --- ## Tabellen in Markdown | Überschrift 1 | Überschrift 2| Anmerkungen | | ------------ | ------------ | ----------- | | Das ist eine Zelle | Das ist noch eine | Bemerkung | | Hier steht noch mehr | Hier nicht||  ---- ## Tabellen in Markdown ``` | Überschrift 1 | Überschrift 2| Anmerkungen | | ------------ | ------------ | ----------- | | Das ist eine Zelle | Das ist noch eine | Bemerkung | | Hier steht noch mehr | Hier nicht|| ``` --- ## Bilder in Markdown ![Katze](https://images.pexels.com/photos/2518134/pexels-photo-2518134.jpeg?auto=compress&cs=tinysrgb&dpr=3&h=750&w=1260 =200x) ``` ![Katze](https://www.katzen.de/bild) ``` --- ## Cheat Sheets * [Emoji-Cheat-Sheet](https://www.webfx.com/tools/emoji-cheat-sheet/) * [HackMD Features](https://hackmd.io/features?both) * [HackMD Syntax](https://www.markdownguide.org/tools/hackmd/) --- ## Präsentationen in Markdown Präsentation: https://hackmd.io/@apachzelt/SyU2eW3N8 Markdown-Skript: https://hackmd.io/@apachzelt/SyU2eW3N8/edit --- # Hands-on --- # Backup ---  ### Machinenlesbarkeit - Ein Beispiel #### Leseransicht > [...] reports of three species, the widespread M. cantiana (Montagu, 1803) and the endemic M. orsini (Villa & Villa, 1841) and M. ruffoi Giusti, 1973, and a number of taxa with uncertain taxonomic status (Alzona 1971; Manganelli et al. 1995). > --- <cite>[Pieńkowska et al. (2020)](https://zookeys.pensoft.net/article/56397/)</cite> ----  ### Machinenlesbarkeit - Ein Beispiel #### Computeransicht `"widespread M. cantiana (Montagu, 1803)"` > [...] widespread <italic>\<tp:taxon-name><tp:taxon-name-part taxon-name-part-type="genus" reg="Monacha">M.</tp:taxon-name-part><tp:taxon-name-part taxon-name-part-type="species" reg="cantiana">cantiana</tp:taxon-name-part></tp:taxon-name></italic>(Montagu, 1803) and [...]

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.