Zum Inhalt

Technischer Hintergrund

Diese Webseite wurde mit dem Tool "mkdocs" und dem Themenaufsatz "material" erstellt. Das ermöglicht es mir, mich sehr wenig mit dem Layout der Seite beschäftigen zu müssen und ich kann mich fast ausschließlich auf die Inhalte konzentrieren.

Bye Bye Wordpress

Markdown als Grundlage

Die Inhalte selbst werden mit Markdown erzeugt. Das ist eine universelle Auszeichnungssyntax für Textgestaltung, sehr simpel, ausbaufähig und gut strukturierbar. Markdown kann nach HTML, als WordDokument, als LaText File oder als PD>F exportiert werden. Markdown hat sich in vielen Applikationen als Standard etabliert

Was ist MarkDown?

Markdown ist eine vereinfachte Auszeichnungssprache, die von John Gruber und Aaron Swartz entworfen und im Dezember 2004 mit Version 1.0.1 spezifiziert wurde. Ein Ziel von Markdown ist eine leicht lesbare Ausgangsform bereits vor der Konvertierung. Als Auszeichnungselemente wurden daher vor allem Auszeichnungsarten verwendet, die in Plain text und E-Mails üblich sind. Auch andere Auszeichnungssprachen mit ähnlichen Zielen zur Lesbarkeit – wie reStructuredText oder Textile – hatten Einfluss auf die Syntax. Der MIME-Type lautet text/markdown.

Eine Markdown-Konvertierungssoftware wandelt Text in gültiges und W3C-konformes XHTML um. Die Referenzimplementierung in Perl steht unter einer BSD-artigen Lizenz. Inzwischen sind Implementierungen in den gängigsten Programmiersprachen wie PHP, Python oder JavaScript sowie R verfügbar.

Alle Infos zur Markdown Syntax ⧉

Installation und Nutzung von MarkDown

Typora

iA Writer

Visual Studio Code

Markdown Erweiterungen

Python als Grundlage für mkdocs

Installation von Python

Installation von mkdocs

Installation von material

Los geht´s - die Nutzung von mkdocs

Die Eingabeaufforderung

New Site

Serve Site

Build

Die wichtigste Datei: mkdocs.yml

Tipps und Tricks