---
title: "Hands-on: Akademisches Schreiben mit Markdown"
tags: markdown, talk, workshop
description: Eine Einführung in Markdown für das Praxislabor digitale Geisteswissenschaften WiSe 2021/2022
author: Christoph Marutschke
slideOptions:
  theme: white
  transition: 'fade'
---

<style type="text/css">
  .reveal p {
    font-size: 0.8em;
  }
  .reveal ul {
    display: block;
    font-size: 0.8em;
  }
  .reveal ol {
    display: block;
    font-size: 0.8em;
  }
 .reveal h1 {
    font-size: 1.8em
  }
  .reveal h2 {
    font-size: 1.4em;
  }
  .reveal h3 {
    font-size: 1em;
  }
  .reveal h4 {
    font-size: 0.8em;
  }
  .reveal pre code {
    max-height: 400px; 
  }
}
</style>

# Spielregeln

- Eigenes Mikrofon: <span style="color: red">**AUS**</span>
- Eigenes Video: <span style="color: green">**AN**</span> oder <span style="color: red">**AUS**</span>
- Buttons:
![](https://i.imgur.com/iL2X4hs.png)<!-- .element style="width: 80%"-->
- Fragen! 

---

# Hands-on: Akademisches Schreiben mit Markdown

## Christoph Marutschke

---

### Ablauf

**Szenario:** Verfassen eines Blog-Post basierend auf einer „eigenen“ wissenschaftlichen Veröffentlichung. Die Aufgabe wird in Kleingruppen in Breakout-Rooms bearbeitet. *Eine Zusammenfassung des Textes ist nicht erforderlich!*

**Alternativ:** Sie suchen sich ein eigenes Thema, z.B. basierend auf einem Wikipedia-Artikel. Oder?

**Materialien:** [Publikation](https://doi.org/10.1088/0957-4484/25/33/335703) und [Manuskript](https://hessenbox-a10.rz.uni-frankfurt.de/getlink/fiMVPDV5LDwQsErxUbzyHqGf/Hands-on_Markdown)

**Bonus:** Veröffentlichen mit Ihrem [GitHub Account](https://education.github.com/pack)

---

## Formeln

### Extended Syntax: hackMD

**mathematische Formeln:** 

$1 \over 2$ 

**chemische Formeln:** 

$CaCO_3$

**In Markdown:**
```markdown
$1 \over 2$
$CaCO_3$
```

---

## Formeln

### ~~Extended Syntax: GitHub~~

**Import als Bild:**

![](https://i.imgur.com/9NCJXwL.png)<!-- .element style="width: 2%"-->

**Umwandlung:** Formel in Bilddatei z.B. via [Sciweavers](http://www.sciweavers.org/free-online-latex-equation-editor)

Über das Ziel und Niveau des Kurses hinaus aber ...
**Lesenswert:**

[How to support latex in GitHub-pages?](https://stackoverflow.com/questions/26275645/how-to-support-latex-in-github-pages)

---

## Sonderzeichen

**Eingabe von Unicode über das Keyboard:**

* Alt + Numpad „+“ + hexdecimal unicode code

*Problem:* Löst oft andere Tastenkombinationen in Windows aus.

**Eingabe über die Zeichentabelle:**

* In die Suchleiste von Windows den Begriff „Zeichentabelle“ eingeben

**Via Copy&Paste**

* z.B. [Wikipedia](https://en.wikipedia.org/wiki/List_of_Unicode_characters)

---

# Extended Syntax

* Für ein optimales Ergebnis bei der Verwendung von Extended Syntax muss das verwendete Markdown genau auf das Zielsystem zugeschnitten werden
* Im Zweifel ist der Export zu HTML die Beste - sprich die interoperable Lösung
* Die meisten Online-Editoren bieten verschiedene Exportformate an und HTML ist immer dabei!

[Weiterführende Informationen](https://www.markdownguide.org/extended-syntax/)

---

## Letzte Vorbereitungen

**Bitte verwenden Sie für das heutige Hands-on den HackMD Editor.**

* Wenn Sie die Veröffentlichung via GitHub Pages mitmachen möchten - dann verwenden Sie für den Login bei [HackMD.io](https://hackmd.io/) bitte Ihren (privaten) Github Account.
* Für die Übertragung des Blog-Post bietet HackMD ein Synchronisierungsfeature mit GitHub (in der kostenfreien Variante auf 20 Durchläufe beschränkt.)

---

## Es geht los!

### Gruppeneinteilung in Breakout-Rooms

#### Bis 13:20 Uhr! - oder wenn Sie fertig sind!

### Viel Spaß!

---

# Erstellung von GitHub Pages

* Login in GitHub & Erstellung eines Repositoriums
* Synchronistation zwischen HackMD und Github (Push)
* Festlegen eines Themes in GitHub (z.B. Cayman)
* Aufrufen der Seite & Endkontrolle :satisfied:

Beispiel: [https://BENUTZERNAME.github.io](https://cm4lib.github.io)

---

![](https://i.imgur.com/EuapbQe.png)<!-- .element style="width: 60%"-->

---

![](https://i.imgur.com/H9pqEKZ.png)<!-- .element style="width: 70%"-->

---

![](https://i.imgur.com/74BRZUK.png)<!-- .element style="width: 100%"-->

---

### Vielen Dank für die Aufmerksamkeit! 

<style>
    .reveal section img { 
        background:none; 
        border:none; box-shadow:none; 
        width: 11%
    }
</style>

Mein Dank gilt: [Adrian Pachzelt](https://github.com/GrazingScientist) 

Kontakt: [Christoph Marutschke](mailto:c.marutschke@ub.uni-frankfurt.de?subject=[Digitale%20Geisteswissenschaften]%20Markdown)

**Link zur Umfrage:** [https://survey.lamapoll.de/Markdown-1](https://survey.lamapoll.de/Markdown-1)

[![License: CC BY 4.0](https://img.shields.io/badge/License-CC_BY_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)