Kapitel 15: Fortgeschrittene Tipps und Tricks

In diesem Kapitel lernen Sie fortgeschrittene Techniken für die professionelle Nutzung von Markdown.

15.1 Tastenkürzel in VS Code

Aktion	Windows/Linux	Mac
Vorschau öffnen	Strg + Umschalt + V	Cmd + Umschalt + V
Vorschau zur Seite	Strg + K, V	Cmd + K, V
Fett	Strg + B	Cmd + B
Kursiv	Strg + I	Cmd + I
Inline-Code	`Strg + Umschalt + ``	`Cmd + Umschalt + ``

15.2 Snippets und Autovervollständigung

VS Code Snippets

Erstellen Sie markdown.json in Ihren VS Code Snippets:

{
  "Insert Admonition": {
    "prefix": "admonition",
    "body": [
      "::: ${1|tip,warning,danger|}",
      "$2",
      ":::"
    ],
    "description": "Insert an admonition block"
  },
  "Insert Code Block": {
    "prefix": "codeblock",
    "body": [
      "```${1:language}",
      "$2",
      "```"
    ],
    "description": "Insert a code block"
  }
}

Autovervollständigung mit Tab

Verwenden Sie Erweiterungen wie "Markdown All in One" für automatische Vervollständigung.

15.3 Reguläre Ausdrücke (Regex) in Markdown

Manche Editoren unterstützen Regex für Suchen und Ersetzen:

Beispiel: Überschriften nummerieren

Suchen: ^(#{1,6}) (.+)$Ersetzen: $1 1. $2

Beispiel: Leerzeilen nach Überschriften hinzufügen

Suchen: ^(#{1,6}.+)$Ersetzen: $1\n

15.4 Große Dokumente strukturieren

Mit vielen Dateien arbeiten

mein-projekt/
├── 00-vorwort.md
├── 01-einleitung.md
├── 02-hauptteil.md
├── 03-fazit.md
└── anhang.md

Inhaltsverzeichnis automatisch generieren

Mit VS Code Erweiterung "Markdown All in One":

1. Drücken Sie Strg + Umschalt + P
2. Wählen Sie "Markdown: Create Table of Contents"

15.5 Markdown mit Datenbanken kombinieren

SQLite für Metadaten

# Markdown-Datei mit Metadaten
sqlite3 metadata.db "CREATE TABLE docs (file TEXT, title TEXT, tags TEXT);"

YAML Front Matter parsen

Verwenden Sie gray-matter in Node.js:

const matter = require('gray-matter');
const fs = require('fs');

const file = fs.readFileSync('post.md', 'utf8');
const {data, content} = matter(file);

console.log(data.title); // Titel aus Front Matter
console.log(content);    // Inhalt ohne Front Matter

15.6 Automatisierung mit Skripten

Python-Skript für Markdown-Validierung

import os
import re

def validate_markdown(file_path):
    with open(file_path, 'r') as f:
        content = f.read()
    
    # Prüfe auf leere Überschriften
    empty_headings = re.findall(r'^#{1,6}\s*$', content, re.MULTILINE)
    if empty_headings:
        print(f"Leere Überschriften gefunden in {file_path}")
    
    # Prüfe auf fehlende Leerzeilen nach Überschriften
    missing_blank = re.findall(r'^(#{1,6}.+)$', content, re.MULTILINE)
    for match in missing_blank:
        print(f"Möglicherweise fehlende Leerzeile nach: {match}")

# Alle .md Dateien prüfen
for root, dirs, files in os.walk('.'):
    for file in files:
        if file.endswith('.md'):
            validate_markdown(os.path.join(root, file))

15.7 Markdown für große Teams

Style Guide erstellen

Erstellen Sie eine STYLEGUIDE.md:

# Markdown Style Guide

## Überschriften
- Verwenden Sie `##` für Hauptabschnitte
- Verwenden Sie `###` für Unterabschnitte
- Keine Leerzeichen in Ankern

## Listen
- Verwenden Sie `-` für ungeordnete Listen
- Verwenden Sie `1.` für geordnete Listen

## Bilder
- Alt-Text muss beschreibend sein
- Bilder in `bilder/` Ordner

Linter in CI/CD einbinden

# .github/workflows/lint.yml
name: Lint Markdown

on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Install markdownlint
        run: npm install -g markdownlint-cli
      - name: Lint Markdown
        run: markdownlint **/*.md

15.8 Zusammenfassung

In diesem Kapitel haben Sie gelernt:

• ✅ Tastenkürzel und Snippets in VS Code
• ✅ Reguläre Ausdrücke für effizientes Bearbeiten
• ✅ Große Dokumente strukturieren
• ✅ Markdown mit Datenbanken kombinieren
• ✅ Automatisierung mit Skripten
• ✅ Markdown für große Teams

Im nächsten Kapitel werden wir die Zukunft von Markdown und verwandte Technologien betrachten!

---

Übung: Erstellen Sie ein VS Code Snippet für Ihre häufig verwendete Markdown-Struktur (z.B. eine Admonition oder ein Code-Block).