FOERBICO/events/workshops/markdown-tutorial.md

122 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Markdown-Tutorial für OER-Multiplikator:innen
**Einführung in die Grundlagen für absolute Beginner**
---
## 📖 Inhaltsverzeichnis
1. [Was ist Markdown?](#-was-ist-markdown)
2. [Warum Markdown für OER?](#-warum-markdown-für-oer)
3. [Syntax-Grundlagen](#-syntax-grundlagen)
4. [Template für OER-Materialien](#-template-für-oer-materialien)
5. [Tools & Tipps](#-tools--tipps)
---
## 🧐 Was ist Markdown?
Markdown ist eine **einfache Auszeichnungssprache**, mit der du Text schnell strukturieren kannst ohne komplexe Software.
- **Plain Text**: Speicherung im `.md`-Format, das jeder Texteditor öffnen kann.
- **Konvertierbar**: Lässt sich in HTML, PDF, Word u. a. umwandeln.
- **Plattformunabhängig**: Funktioniert auf GitHub, Blogs, Lernplattformen uvm.
---
## 🌟 Warum Markdown für OER?
-**Barrierefrei**: Keine teure Software nötig.
-**Kollaboration**: Einfaches Teilen und Versionieren (z. B. mit GitHub).
-**Langzeitverfügbarkeit**: Zukunftssichere Textdateien.
-**Anpassbar**: Perfekt für Remixing von OER-Materialien.
---
## 📝 Syntax-Grundlagen
### Überschriften
```markdown
# H1-Überschrift
## H2-Überschrift
### H3-Überschrift
```
### Textformatierung
```markdown
*Kursiv* oder _Kursiv_
**Fett** oder __Fett__
~~Durchgestrichen~~
> Zitatblock
```
### Listen
```markdown
- Ungeordnete Liste
1. Geordnete Liste
- [ ] Checkliste
- [x] Erledigt
```
### Links & Bilder
```markdown
[Linktext](https://beispiel.de)
![Alt-Text](pfad/zum/bild.jpg)
```
### Tabellen
```markdown
| Spalte 1 | Spalte 2 |
|----------|----------|
| Inhalt | Inhalt |
```
### Code
`` `Einzeiliger Code` ``
```python
Mehrzeiliger Codeblock
```
---
## 📄 Template für OER-Materialien
```markdown
# Titel deines OER-Materials
**Autor:in** · **Datum** · [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
---
## Einführung
{{ Kurze Beschreibung des Themas und Lernziele }}
---
## Inhaltsabschnitt 1
### Unterüberschrift
- {{ Punkt 1 }}
- {{ Punkt 2 }}
> {{ Zitat oder Hinweis }}
---
## Aufgabe
1. **Schritt 1**: {{ Beschreibung }}
```markdown
[Beispiellink](https://open-education.global)
```
---
## 🛠️ Tools & Tipps
- **Editoren**: [VS Code](https://code.visualstudio.com/), [StackEdit](https://stackedit.io/)
- **Konvertierung**: [Pandoc](https://pandoc.org/) für PDF/Word
- **OER-Hosting**: [GitHub](https://github.com/), [OER Commons](https://www.oercommons.org/)
💡 **Tipp für Multiplikator:innen**:
Nutze Metadaten im Dokumentkopf für Lizenzangaben und Beschreibung!
---
📜 **Lizenzhinweis**
Dieses Tutorial steht unter [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
Gestaltet von [Dein Name] · Anpassungen erwünscht! ✨
---
```
🚀 **Loslegen**: Kopiere dieses Template, füge deine Inhalte ein und teile sie als OER!
```