Einleitung

Die Erstellung von Scripten und Inhalte in verschiedenen Formaten (z. B. PDF, HTML) ist mit herkömmlichen Textverarbeitungsprogrammen durchaus schwierig und vor allem auch mit umfangreichen Zeitaufwänden bei der Konvertierung in die verschiedenen Formate verbunden. Mit Hilfe der Auszeichnungssprache Markdown, bzw. den Softwareprodukten Visual Studio Code und Quarto können ganz einfach Inhalte in unterschiedliche Quellen (z. B. HTML, PDF) umgewandelt werden. Zudem können auch interaktive Elemente (z. B. Videos) in bestimmte Exportformate eingepflegt werden.

Grundvoraussetzung

Grundvoraussetzung für das Arbeiten mit Markdown ist:

• Grundkenntnisse in Markdown
• Installation und Umgang mit den Softwareprodukten Visual Studio Code und Quarto
• Bereitschaft, die Inhalte in Markdown zu pflegen

Beispiel

Beispiel einer Markdown-Datei:

---
title: "Digitale Scripten mit Markdown und Quarto erstellen"
author: "TOP Lehre Team FH OÖ"
abstract: "Markdown ermöglicht zusammen mit Visual Studio Code und Quarto die digitale Erstellung
von Scripten und deren Kompilierung in unterschiedliche Exportformate (z. B. HTML, PDF)."
format: html
toc: true
toc-depth: 2
toc-title: Inhaltsverzeichnis
toc-location: left
---

# Was ist Markdown
Markdown ist eine vereinfachte Auszeichnungssprache mit dem Ziel,
eine leicht lesbare Ausgangsform bereits vor der Konvertierung zu erhalten.
 Daher werden bereits bekannte Auszeichnungselemente verwendet [^1].

Die Bedienung von Markdown ist ähnlich wie bei LaTeX und erfordert daher entsprechende Kenntnisse
 der Softwareprodukte, sowie der entsprechenden Auszeichnungselemente.

[^1]: Markdown [https://de.wikipedia.org/wiki/Markdown](https://de.wikipedia.org/wiki/Markdown)

## Formatierungsoptionen in Markdown
Markdown verwendet bestimmte Auszeichnungselemente für die Gestaltung der Inhalte, diese sind beispielsweise:

* Textformatierung: fett, kursiv, unterstrichen
* Aufzählungszeichen
* Überschriften (Ebene 1 - 4)
* Zitate und Fußnoten
* Tabellen
* Codeblöcke
* Bilder
* Hervorhebungen
* Links, etc.


Hervorhebungen können wie folgt gestaltet werden:

:::{.callout-note}
Es gibt fünf verschiedene Möglichkeiten, wie man Hervorhebungen gestalten kann: 
`note`, `warning`, `important`, `tip`, und `caution`.
:::

Vorteile

• unterschiedliche Exportformate (z. B. HTML, PDF)
• Exportformate können einfach in das Lernmanagementsystem importiert werden (z. B. als ganze HTML-Seiten oder auch als einzelne PDF)
• Interaktive Formate (z. B. Videos) möglich
• Einfache, aber umfangreiche Formatierungsoptionen möglich

---

Gerne stehen Ihnen das TOP Lehre Team der FH OÖ zur Unterstützung zur Verfügung.