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:
