Resize-ImageForMarkdown

ÜBERSICHT

Skaliert und bearbeitet Bilder für optimale Darstellung in Markdown-Dokumenten.

SYNTAX

Resize-ImageForMarkdown [-ImagePath] <string> [[-CanvasWidth] <int>] [[-ScalePercent] <int>]
    [[-PaddingLeft] <int>] [[-PaddingRight] <int>] [[-PaddingTop] <int>] [[-PaddingBottom] <int>]
    [[-Alignment] <string>] [[-BackgroundColor] <string>] [[-Filter] <string>] [[-OutputPath]
    <string>] [<CommonParameters>]

BESCHREIBUNG

Die Funktion Resize-ImageForMarkdown skaliert ein Bild automatisch auf eine angegebene Leinwandbreite, berücksichtigt dabei optionalen Platzbedarf für Effekte (wie Schatten, Emboss oder Rahmen), und zentriert oder linksbündig es mit individuellem Padding. Verschiedene visuelle Filter ermöglichen professionelle Darstellungen für technische Dokumentationen, insbesondere für Dialog-Screenshots.

PARAMETER

-ImagePath

Type: string

Pfad zum Eingangsbild (Pflichtparameter).

-CanvasWidth

Type: int
Default: 1500

Maximale Breite der resultierenden Leinwand. Das Bild wird automatisch proportional verkleinert, falls erforderlich.

-ScalePercent

Type: int
Default: 85

Prozentuale Skalierung des Bildes, wenn es kleiner als die verfügbare Leinwandbreite ist.

-PaddingLeft

Type: int
Default: 20

Linkes Padding (Innenabstand) des Bildes auf der Leinwand in Pixel.

-PaddingRight

Type: int
Default: 20

Rechtes Padding (Innenabstand) des Bildes auf der Leinwand in Pixel.

-PaddingTop

Type: int
Default: 20

Oberes Padding (Innenabstand) des Bildes auf der Leinwand in Pixel.

-PaddingBottom

Type: int
Default: 20

Unteres Padding (Innenabstand) des Bildes auf der Leinwand in Pixel.

-Alignment

Type: string
Default: 'Center'

Ausrichtung des Bildes innerhalb der Leinwand. Mögliche Werte sind 'Center' oder 'Left'.

-BackgroundColor

Type: string
Default: 'Transparent'

Hintergrundfarbe der Leinwand. Möglich sind 'White' oder 'Transparent'.

-Filter

Type: string
Default: 'Shadow'

Optionaler visueller Filter-Effekt: 'None', 'Shadow', 'Emboss' oder 'Border'.

-OutputPath

Type: string

Ausgabepfad des erzeugten Bildes. Falls nicht angegeben, wird der Name aus dem Originalbild abgeleitet und mit dem Suffix "_markdown" versehen.

AUSGABEN

string

Gibt den vollständigen Pfad des erzeugten Markdown-Bildes zurück.

BEISPIELE

# Erstellt ein mittig platziertes Bild mit Rahmen, das maximal 1200 Pixel breit ist.
Resize-ImageForMarkdown -ImagePath 'C:\temp\bild.png' -CanvasWidth 1200 -ScalePercent 100 -Filter Border -Alignment Center

HINWEISE

• Optimiert für technische Markdown-Dokumentationen.
• Bilder können in der PowerShell-Synopsis direkt über Markdown-Bildlinks eingebettet werden: ``