📖 Was ist der Markdown-Block?

#

Der Markdown-Block ist ein flexibler Content-Block, mit dem Sie formatierte Texte und Lerninhalte direkt in Aptigo erstellen können.

Statt einen langen Text nur als einfachen Fließtext darzustellen, können Sie mit Markdown beispielsweise:

• 📝 Überschriften und Absätze strukturieren
• wichtige Begriffe hervorheben
• Listen und Aufzählungen erstellen
• 📊 Tabellen einfügen
• 💻 Quellcode übersichtlich darstellen
• 🖼️ Bilder einbinden
• 🔗 Links setzen
• 📐 mathematische Formeln darstellen
• 💡 Hinweise und besondere Textbereiche gestalten

Der große Vorteil: Sie schreiben den Inhalt in einem einfachen Textformat und erhalten daraus automatisch eine übersichtlich formatierte Darstellung.

💡 Pädagogischer Mehrwert: Der Markdown-Block eignet sich besonders für Inhalte, bei denen die Vermittlung von Wissen und Informationen im Vordergrund steht. Er ist ideal für Erklärtexte, Lernmaterialien, Anleitungen, Zusammenfassungen und ergänzende Informationen.

🎯 Wann sollten Sie den Markdown-Block verwenden?

#

Der Markdown-Block ist besonders geeignet, wenn Schüler einen Inhalt lesen, verstehen und anschließend als erledigt markieren sollen.

Als Einführung in ein neues Thema

#

Bereiten Sie einen kurzen Informationstext vor, der die wichtigsten Grundlagen eines neuen Themas erklärt.

Beispiel:

Thema: Der Treibhauseffekt

Der Treibhauseffekt beschreibt die Erwärmung der Erdoberfläche durch bestimmte Gase in der Atmosphäre.

Anschließend können Sie einen interaktiven Content-Block einsetzen, in dem das Wissen angewendet wird.

Als Lern- oder Infotext

#

Der Markdown-Block eignet sich hervorragend für:

• 📖 Definitionen
• 📚 Hintergrundinformationen
• 🧠 Merksätze
• 📋 Zusammenfassungen
• 🔍 Schritt-für-Schritt-Erklärungen
• 💻 Programmieranleitungen
• 🧪 Versuchsanleitungen
• 📐 Formelsammlungen

Als Anleitung

#

Sie können Schüler Schritt für Schritt durch eine Aufgabe führen.

Beispiel:

## So gehst du vor

1. Öffne Visual Studio.
2. Erstelle ein neues Projekt.
3. Wähle eine Konsolenanwendung.
4. Schreibe den folgenden Code.
5. Starte das Programm.

Damit können Sie beispielsweise eine nachfolgende Programmieraufgabe vorbereiten.

Als Ergänzung zu interaktiven Aufgaben

#

Der Markdown-Block kann auch als Informationsbaustein innerhalb eines Lernpfades verwendet werden.

Eine mögliche Struktur:

1. 📝 Markdown-Block – Einführung
2. 🧩 Interaktive Aufgabe – Wissen anwenden
3. ❓ Quiz – Wissen überprüfen
4. 🔐 Tresor – Lernerfolg kontrollieren
5. 🏆 Trophäe – Abschluss

So können Sie Informationen und Interaktion sinnvoll miteinander verbinden.

🛠️ Einen Markdown-Block erstellen

#

Schritt 1: Neuen Content hinzufügen

#

Im Aptigo-Editor klicken Sie auf „Neuen Inhalt erstellen“ und wählen „Markdown-Text“ aus.

Schritt 2: Markdown-Text eingeben

#

Im Editor erscheint ein großes Eingabefeld.

Hier können Sie Ihren Text direkt als Markdown schreiben.

Während der Eingabe sehen Sie darunter eine Live-Vorschau.

So können Sie direkt überprüfen, wie der Inhalt später für die Schüler dargestellt wird.

💡 Tipp: Sie müssen Markdown nicht komplett auswendig lernen. Für die meisten Lerninhalte reichen bereits einige wenige Formatierungen aus.

✏️ Die wichtigsten Markdown-Formatierungen

#

Überschriften

#

Überschriften werden mit # erstellt.

# Große Überschrift

## Überschrift

### Unterüberschrift

Je mehr # verwendet werden, desto kleiner wird die Überschrift.

Beispiel:

# Der menschliche Körper

## Das Verdauungssystem

### Der Magen

Das eignet sich hervorragend, um längere Lerntexte zu strukturieren.

Text hervorheben

#

Fett

#

**Dieser Text ist besonders wichtig.**

Ergebnis:

Dieser Text ist besonders wichtig.

Kursiv

#

*Dieser Text ist hervorgehoben.*

Ergebnis:

Dieser Text ist hervorgehoben.

Kombination

#

**Wichtig:** Die Variable muss vom Datentyp `int` sein.

Listen

#

Aufzählung

#

- Erster Punkt
- Zweiter Punkt
- Dritter Punkt

Ergebnis:

• Erster Punkt
• Zweiter Punkt
• Dritter Punkt

Nummerierte Liste

#

1. Schritt eins
2. Schritt zwei
3. Schritt drei

Ergebnis:

1. Schritt eins
2. Schritt zwei
3. Schritt drei

💡 Tipp: Nummerierte Listen eignen sich besonders gut für Arbeitsanweisungen und Schritt-für-Schritt-Anleitungen.

Tabellen

#

Mit Markdown können Sie übersichtliche Tabellen erstellen.

| Datentyp | Beispiel | Beschreibung |
|----------|----------|--------------|
| `int` | `42` | Ganze Zahl |
| `double` | `3.14` | Kommazahl |
| `string` | `"Hallo"` | Text |
| `bool` | `true` | Wahrheitswert |

Die Darstellung sieht dann beispielsweise so aus:

💡 Pädagogischer Tipp: Tabellen sind besonders hilfreich, wenn mehrere Begriffe miteinander verglichen werden sollen.

💻 Quellcode darstellen

#

Gerade für den Informatikunterricht ist Markdown besonders praktisch.

Code kann mit drei Backticks dargestellt werden:

```csharp
int alter = 15;

if (alter >= 18)
{
    Console.WriteLine("Volljährig");
}
```

Dadurch wird der Code übersichtlich und mit entsprechender Formatierung dargestellt.

Beispiel:

int alter = 15;

if (alter >= 18)
{
    Console.WriteLine("Volljährig");
}

💡 Tipp: Geben Sie nach den ersten drei Backticks die Programmiersprache an, z. B. csharp, python oder javascript. Dadurch kann der Code passend dargestellt werden.

🖼️ Bilder einfügen

#

Auch Bilder können über Markdown eingebunden werden.

![Beschreibung des Bildes](/screenshots/beispiel.png)

Die allgemeine Struktur lautet:

![Alternativtext](Pfad-zum-Bild)

Der Text in den eckigen Klammern beschreibt das Bild und wird beispielsweise angezeigt, wenn das Bild nicht geladen werden kann.

⚠️ Wichtig: Bei Dateinamen muss auf die Groß- und Kleinschreibung geachtet werden. Unter Linux sind Bild.png, bild.png und BILD.PNG unterschiedliche Dateinamen.

💡 Tipp für Aptigo: Bilder, die Bestandteil Ihrer Dokumentation sind, sollten Sie in der vorgesehenen Hugo-Ordnerstruktur ablegen und anschließend mit dem korrekten Pfad referenzieren.

🔗 Links einfügen

#

Ein Link wird folgendermaßen erstellt:

[OpenAI](https://openai.com)

Das Ergebnis ist ein anklickbarer Link:

OpenAI

Sie können damit beispielsweise auf weiterführende Informationen, externe Webseiten oder Quellen verweisen.

💡 Hinweise und besondere Bereiche

#

Markdown unterstützt auch besondere Hervorhebungen.

Beispielsweise kann ein Hinweis als Blockquote dargestellt werden:

> 💡 **Tipp:** Lies den Text aufmerksam durch.

Ergebnis:

💡 Tipp: Lies den Text aufmerksam durch.

Dies eignet sich besonders für:

• 💡 Tipps
• ⚠️ Warnungen
• 🧠 Merksätze
• 📌 wichtige Informationen

📐 Mathematische Formeln

#

Der Markdown-Block unterstützt auch die Darstellung mathematischer Formeln.

Beispielsweise:

$$
a^2 + b^2 = c^2
$$

Damit können Sie mathematische Zusammenhänge übersichtlich darstellen.

Dies ist besonders praktisch für:

• 📐 Mathematik
• ⚡ Physik
• 🧪 Chemie
• 💻 Informatik
• 📊 Statistik

Auch Formeln innerhalb eines Textes können verwendet werden.

Beispielsweise:

Die Fläche eines Kreises berechnet sich mit $A = \pi r^2$.

💡 Tipp: Formeln eignen sich besonders gut, wenn Sie zunächst eine Formel erklären und anschließend eine interaktive Aufgabe dazu anbieten.

🎓 Aus Schülersicht

#

Wenn Schüler einen Markdown-Block erreichen, sehen sie den fertig formatierten Lerninhalt.

Der Schüler kann:

1. 📖 den Text lesen
2. 🖼️ Bilder und Grafiken betrachten
3. 💻 Codebeispiele nachvollziehen
4. 📊 Tabellen und Übersichten lesen
5. 📐 Formeln betrachten
6. ✅ anschließend auf „Gelesen & Verstanden“ klicken

Der Markdown-Block ist damit bewusst kein Quiz und keine Prüfung.

Er dient dazu, dass Schüler einen bereitgestellten Lerninhalt selbstständig bearbeiten können.

💡 Wichtig: Der Button „Gelesen & Verstanden“ bestätigt lediglich, dass der Schüler den Inhalt bearbeitet hat. Es wird dabei nicht überprüft, ob der Inhalt tatsächlich verstanden wurde.

🧠 Clevere Einsatzmöglichkeiten

#

Variante 1: Lerntext + Quiz

#

Ein Markdown-Block vermittelt zunächst das notwendige Wissen.

📝 Markdown
     ↓
❓ Quiz
     ↓
🏆 Ergebnis

Beispiel:

• Markdown erklärt die Datentypen int, double, string und bool
• Ein Quiz fragt die Unterschiede ab
• Die Schüler wenden ihr Wissen an

Variante 2: Erklärung + Programmieraufgabe

#

Gerade im Informatikunterricht bietet sich folgende Struktur an:

📝 Erklärung
     ↓
💻 Codebeispiel
     ↓
🧩 Programmieraufgabe
     ↓
🏆 Erfolg

Der Markdown-Block kann dabei den notwendigen Programmcode und die Erklärung enthalten.

Anschließend bearbeiten die Schüler eine praktische Aufgabe.

Variante 3: Theorie + interaktiver Content

#

Der Markdown-Block kann als Vorbereitung für nahezu jeden anderen Content-Block eingesetzt werden.

Beispiel:

📝 Markdown
"Was ist eine Schleife?"

        ↓

🧩 Aufgabe
"Vervollständige den Code"

        ↓

❓ Quiz
"Welche Schleife eignet sich?"

        ↓

🔐 Tresor
"Überprüfe dein Wissen"

🎨 Gute Markdown-Texte erstellen

#

Ein Markdown-Block kann sehr viel Inhalt aufnehmen. Trotzdem sollte ein Lerntext nicht unnötig lang werden.

Dos

#

• ✅ Inhalte klar strukturieren
• ✅ Überschriften verwenden
• ✅ wichtige Begriffe hervorheben
• ✅ kurze Absätze schreiben
• ✅ Tabellen für Vergleiche verwenden
• ✅ Code in Codeblöcken darstellen
• ✅ Bilder gezielt einsetzen
• ✅ Informationen mit anschließenden Aufgaben verbinden

Don’ts

#

• ❌ Zu lange Textwüsten schreiben
• ❌ Eine Seite mit zu vielen Überschriften überladen
• ❌ Wichtige Informationen nur durch Farbe hervorheben
• ❌ Große Mengen an Informationen ohne Struktur präsentieren
• ❌ Den Markdown-Block als Ersatz für interaktive Aufgaben verwenden

💡 Merksatz: Der Markdown-Block vermittelt Wissen – andere Content-Blöcke lassen die Schüler dieses Wissen anwenden.

📊 Markdown-Block und Mindestpunktzahl

#

Der Markdown-Block kann wie andere Content-Blöcke in einen Lernpfad integriert werden.

Die Sichtbarkeit kann dabei von der erreichten Punktzahl abhängig gemacht werden.

💡 Tipp: Ein Markdown-Block eignet sich gut als vorbereitender Lerninhalt, der nach einer vorherigen Aufgabe freigeschaltet wird.

🤔 Warum gibt es einen Markdown-Block, wenn es bereits den Textblock gibt?

#

Eine berechtigte Frage: Aptigo bietet bereits den klassischen Textblock mit Quill-Editor. Warum also noch einen Markdown-Block?

Die Antwort lautet: Beide Blöcke verfolgen unterschiedliche Arbeitsweisen.

Der Textblock ist ideal, wenn Sie Inhalte visuell gestalten möchten. Sie schreiben Ihren Text und formatieren ihn direkt über die Toolbar – ähnlich wie in Word oder Google Docs.

Der Markdown-Block richtet sich dagegen an Lehrkräfte, die Inhalte strukturiert und textbasiert erstellen möchten – und insbesondere an alle, die dabei die integrierte KI-Unterstützung nutzen möchten.

💡 Kurz gesagt: Der Textblock ist Ihr digitales Textverarbeitungsprogramm. Der Markdown-Block ist Ihr Werkzeug für strukturierte Inhalte – mit eingebauter KI-Unterstützung.

🤖 Der besondere Vorteil: Inhalte mit KI erstellen

#

Der Markdown-Block kann seine Inhalte nicht nur manuell über Markdown erstellen.

Mit dem integrierten KI-Editor können Sie Inhalte auch einfach per Prompt erstellen lassen.

Sie müssen beispielsweise nicht selbst einen vollständigen Lerntext über ein Thema formulieren. Beschreiben Sie der KI einfach, was Sie benötigen.

Beispiel

#

Sie möchten einen Lerntext zum Thema Photosynthese erstellen.

Statt den gesamten Text selbst zu schreiben, können Sie der KI beispielsweise folgende Anweisung geben:

Erstelle einen Lerntext für eine 7. Klasse zum Thema Photosynthese. Erkläre den Vorgang einfach und verständlich. Verwende die Überschriften „Was ist Photosynthese?“, „Was benötigen Pflanzen?“ und „Was entsteht bei der Photosynthese?“. Füge am Ende eine kurze Zusammenfassung mit den drei wichtigsten Punkten hinzu.

Die KI erstellt daraus direkt einen strukturierten Markdown-Inhalt.

Anschließend können Sie:

1. 🤖 den Inhalt von der KI erstellen lassen
2. 👀 die Live-Vorschau überprüfen
3. ✏️ den Text bei Bedarf manuell bearbeiten
4. ➕ eigene Informationen ergänzen
5. 📝 den fertigen Inhalt speichern

💡 Der entscheidende Vorteil: Die KI erstellt nicht einfach nur einen Fließtext. Sie kann den Inhalt direkt strukturieren und formatieren – mit Überschriften, Listen, Tabellen, Codeblöcken und weiteren Markdown-Elementen.

🧠 KI als Schreibassistent nutzen

#

Die KI muss nicht zwingend den kompletten Inhalt erstellen.

Sie kann auch bestehende Inhalte bearbeiten oder erweitern.

Inhalte vereinfachen

#

„Formuliere diesen Text so um, dass ihn Schüler einer 6. Klasse verstehen können.“

Inhalte erweitern

#

„Ergänze drei Beispiele aus dem Alltag.“

Inhalte strukturieren

#

„Strukturiere diesen Text mit passenden Überschriften und Aufzählungen.“

Zusammenfassen

#

„Fasse den folgenden Text in fünf wichtigen Stichpunkten zusammen.“

Aufgaben erstellen

#

„Erstelle am Ende des Textes drei Verständnisfragen zum Inhalt.“

Tabellen erstellen

#

„Erstelle aus den Informationen eine übersichtliche Vergleichstabelle.“

Fachlich anpassen

#

„Erkläre den Inhalt auf dem Niveau einer 9. Klasse im Informatikunterricht.“

🚀 Ein typischer Workflow

#

Der Markdown-Block eignet sich besonders für einen modernen Workflow bei der Erstellung von Lerninhalten:

💡 Idee
   ↓
🤖 Prompt an die KI
   ↓
📝 Markdown-Inhalt wird erstellt
   ↓
👀 Live-Vorschau prüfen
   ↓
✏️ Inhalte anpassen
   ↓
📚 In Lernpfad einfügen
   ↓
👨‍🎓 Schüler lesen und bestätigen

Sie behalten dabei jederzeit die Kontrolle über den Inhalt.

Die KI ist ein Werkzeug zur Unterstützung, die endgültige Entscheidung über Inhalt, Formulierung und fachliche Richtigkeit liegt weiterhin bei Ihnen als Lehrkraft.

⚠️ Wichtig: Prüfen Sie KI-generierte Inhalte immer auf fachliche Richtigkeit. Die KI kann Fehler machen oder Informationen ungenau darstellen.

🆚 Welchen Block soll ich verwenden?

#

Verwenden Sie den Textblock, wenn …

#

• Sie schnell einen kurzen Informationstext erstellen möchten
• Sie lieber visuell wie in Word arbeiten
• Sie Inhalte direkt über eine Toolbar formatieren möchten
• Sie Bilder direkt über den Editor einfügen möchten
• Sie keine Markdown-Syntax verwenden möchten

Verwenden Sie den Markdown-Block, wenn …

#

• Sie längere Lerntexte erstellen
• Sie viele Überschriften und Listen verwenden
• Sie Tabellen benötigen
• Sie Quellcode darstellen möchten
• Sie mathematische Formeln benötigen
• Sie dokumentationsartige Inhalte erstellen
• Sie Inhalte strukturiert aus einer anderen Quelle übernehmen möchten
• Sie gerne mit textbasierten Formaten arbeiten
• 🤖 Sie die KI zur Erstellung und Bearbeitung von Lerninhalten nutzen möchten

🎯 Unsere Empfehlung: Für einen kurzen, visuell gestalteten Informationstext ist der Textblock oft die schnellste Wahl. Für umfangreiche, strukturierte Lerninhalte oder wenn Sie die KI zur Inhaltserstellung einsetzen möchten, ist der Markdown-Block besonders interessant.

💡 Beispiel: Ein Lerntext in wenigen Minuten

#

Sie planen eine Unterrichtseinheit zum Thema „Schleifen in C#“.

Im KI-Editor des Markdown-Blocks geben Sie beispielsweise ein:

Erstelle einen Lerntext für eine 9. Klasse zum Thema for-Schleifen in C#.

Erkläre:

• Was ist eine Schleife?
• Was ist ein Schleifenzähler?
• Wie funktioniert eine for-Schleife?

Verwende ein einfaches C#-Beispiel.

Erstelle anschließend eine Tabelle mit den drei Bestandteilen einer for-Schleife: Initialisierung, Bedingung und Veränderung.

Füge am Ende drei kurze Merksätze hinzu.

Sie erhalten daraus einen strukturierten Lerntext, den Sie anschließend direkt im Markdown-Editor überprüfen und anpassen können.

Damit wird aus:

„Ich muss noch einen Lerntext schreiben.“

ein:

„Ich beschreibe der KI, welchen Lerntext ich brauche, prüfe das Ergebnis und passe es an.“

🎉 So wird der Markdown-Block nicht nur zu einem Textblock, sondern zu einem Werkzeug für die schnelle Erstellung und Aufbereitung von Lerninhalten.

📋 Kurzzusammenfassung

#

Das passiert dann:

Lehrkraft erstellt Markdown-Text → Live-Vorschau kontrollieren → Inhalt veröffentlichen → Schüler lesen den Inhalt → Schüler klicken auf „Gelesen & Verstanden“ → Lernpfad kann fortgesetzt werden. 🎉

🚀 Kurz gesagt

#

Der Markdown-Block ist der ideale Content-Block für strukturierte Wissensvermittlung.

Er verbindet die Einfachheit eines Texteditors mit den Möglichkeiten von Markdown und eignet sich dadurch besonders für Erklärtexte, Lernmaterialien, Anleitungen, Codebeispiele und theoretische Grundlagen.

📝 Markdown erklärt.

🧩 Interaktive Blöcke lassen anwenden.

🏆 Aptigo macht daraus einen Lernpfad.