← Zurück zum Blog

Entwickler-Notizen: Technische Inhalte als Code-First Markdown speichern

· Save Team
developercodedocumentationapitemplates

Es ist 2 Uhr nachts, du debuggst. Du findest die Stack-Overflow-Antwort. Du brauchst den Code-Block, die Erklarung und sonst nichts. Nicht die 47 “Hab das gleiche Problem”-Kommentare. Nicht die Sidebar-Werbung. Nicht das Karussell mit verwandten Fragen.

Das Developer-Template von Save entfernt alles ausser dem, was ein Entwickler wirklich braucht: Code, API-Referenzen und technischen Kontext.

Das Leseproblem fur Entwickler

Technische Inhalte im Web sind unter Rauschen begraben:

  • Stack Overflow — Antworten umgeben von Votes, Kommentaren, Werbung
  • Dokumentation — wichtiger Code versteckt in Erklarungsabsatzen
  • Blog-Tutorials — “Zunachst mochte ich euch erzahlen, warum ich JavaScript liebe…”
  • GitHub-READMEs — das eine Code-Beispiel, das du brauchst, ist 400 Zeilen weiter unten
  • API-Referenzen — nutzliche Tabelle versteckt zwischen Textwanden

So funktioniert das Developer-Template

Das Developer-Template von Save gibt ein Code-First-Format mit funf Bereichen aus:

  1. TL;DR — die Losung in einem Satz
  2. Uberblick — technischer Kontext ohne Drumherum
  3. Code-Beispiele — jeder Code-Block exakt erhalten
  4. API-Referenz — Tabellen mit Methoden, Parametern, Ruckgabetypen
  5. Hinweise — Sonderfalle, Stolperfallen, versionsspezifisches Verhalten

Alle Code-Blocke werden mit Syntax-Highlighting-Markierungen erhalten. Fachbegriffe bleiben intakt. Marketing-Sprache wird entfernt.

Beispielausgabe

Von einer Next.js-Dokumentationsseite uber Server Actions:

## TL;DR

Server Actions sind asynchrone Funktionen, die auf dem Server
laufen, mit der Direktive 'use server' definiert werden und
direkt aus Client Components aufgerufen werden konnen.

## Uberblick

Server Actions machen API-Routen in den meisten Mutations-
Szenarien uberflussig. Sie integrieren sich in die Caching-
und Revalidierungssysteme von Next.js. Nur im App Router verfugbar.

## Code-Beispiele

### Einfache Server Action

\`\`\`typescript
'use server'

export async function createPost(formData: FormData) {
  const title = formData.get('title') as string
  await db.posts.create({ data: { title } })
  revalidatePath('/posts')
}
\`\`\`

### Verwendung in einer Client Component

\`\`\`typescript
'use client'

import { createPost } from './actions'

export function PostForm() {
  return (
    <form action={createPost}>
      <input name="title" />
      <button type="submit">Create</button>
    </form>
  )
}
\`\`\`

## API-Referenz

| Funktion | Parameter | Ruckgabe |
|----------|-----------|----------|
| revalidatePath | path: string | void |
| revalidateTag | tag: string | void |
| redirect | url: string | never |
| cookies() | none | ReadonlyRequestCookies |

## Hinweise

- Server Actions mussen asynchrone Funktionen sein
- Die Direktive 'use server' kann auf Funktions- oder Dateiebene stehen
- Maximale Request-Body-Grosse: standardmassig 1 MB
- Funktioniert mit Progressive Enhancement (kein JS erforderlich)
- Kann nicht in Client-Component-Dateien definiert werden

Perfekte Anwendungsfalle

Stack-Overflow-Antworten speichern

Erhalte die akzeptierte Antwort mit Code-Blocken, ohne den UI-Ballast. Perfekt zum Aufbau einer personlichen Code-Referenzbibliothek.

Dokumentations-Snapshots

Speichere Doku-Seiten, bevor sie sich andern. Versionierte APIs, veraltete Features, Migrationsleitfaden — behalte eine lokale Kopie.

Tutorial-Extraktion

Speichere Coding-Tutorials, reduziert auf die wesentlichen Schritte und den Code. Keine Hintergrundgeschichte des Autors, kein SEO-Fullmaterial.

API-Referenz-Sammlung

Baue dir ein personliches API-Spickzettel, indem du Referenzseiten im Developer-Format speicherst. Die Tabellenausgabe ist sofort nutzbar.

Code-Review-Kontext

Speichere relevante Dokumentation beim Review von unbekanntem Code. Teile developer-formatierte Referenzen in PR-Kommentaren.

So richtest du es ein

  1. Installiere Save aus dem Chrome Web Store (kostenlos)
  2. Offne die Einstellungen und wahle “Developer 💻”
  3. Besuche eine beliebige technische Seite — Doku, Stack Overflow, Tutorials
  4. Klicke auf Save — Code-First Markdown sofort
  5. Speichere es in deinem Vault — Obsidian, VS Code Notes, GitHub Wiki

Von Entwicklern, fur Entwickler

Hor auf, Code-Blocke manuell zu kopieren. Hor auf, Dokumentation umzuformatieren. Hor auf, dich durch Tutorial-Fullmaterial zu kampfen, um den einen Befehl zu finden, den du brauchst.

Das Developer-Template von Save liefert dir Code-First Markdown von jeder technischen Seite. Sauber, strukturiert, sofort einsatzbereit.

Teste Save kostenlos im Chrome Web Store