Markdown-Bilder
Bilder können Dokumente lebendiger und leichter verständlich machen.
Die Bildsyntax von Markdown ist einfach und flexibel.
Das Format der Markdown-Bildsyntax ist wie folgt:
 
- Beginnen Sie mit einem Ausrufezeichen !
- Dann eine eckige Klammer, in die Sie den Alternativtext für das Bild schreiben.
- Dann eine runde Klammer, in die Sie die Bild-URL einfügen, und abschließend können Sie optional Text für das Attribut 'title' in Anführungszeichen angeben.
Beispiel für relativen Pfad:
  
Beispiel für absoluten Pfad:
 
Empfehlungen zur Pfadverwendung:
- Es wird empfohlen, relative Pfade zu verwenden, um die Portabilität des Projekts zu erleichtern.
- Es wird empfohlen, einen dedizierten Bilderordner zu erstellen (z. B. images/, assets/).
- Verwenden Sie aussagekräftige Dateinamen für eine einfachere Verwaltung.
- Beachten Sie die Unterschiede bei Pfadtrennzeichen zwischen verschiedenen Betriebssystemen.
Online-Bilder direkt referenzieren:
 
Das angezeigte Ergebnis sieht wie folgt aus:

Natürlich können Sie auch Variablen für Bild-URLs verwenden, genau wie bei URLs:
这个链接用 1 作为网址变量 [EXAMPLE][1]. 然后在文档的结尾为变量赋值(网址) [1]: /static.jyshare.com/images/example-logo.png
Das angezeigte Ergebnis sieht wie folgt aus:

Markdown bietet noch keine Möglichkeit, die Höhe und Breite von Bildern anzugeben. Bei Bedarf können Sie ein normales <img>-Tag verwenden.
<img src="../static.jyshare.com/images/example-logo.png?v=2" width="50%">
Das angezeigte Ergebnis sieht wie folgt aus:

Verwendung von CDN-Diensten:
 
Hinweise zu Online-Bildern:
- Stellen Sie die Stabilität und Erreichbarkeit der Bild-URL sicher.
- Beachten Sie Urheberrechtsfragen bei Bildern.
- Berücksichtigen Sie Ladegeschwindigkeit und Netzwerkumgebung.
- Es wird empfohlen, wichtige Bilder lokal zu sichern.
Bedeutung von Alt-Text für Bilder
Alt (Alternativtext) bietet alternative Informationen, wenn ein Bild nicht angezeigt werden kann, und ist auch wichtig für Barrierefreiheit und SEO:
Beispiel für guten Alt-Text:
  
Zu vermeidender Alt-Text:
 // 太简单,没有描述性  // 完全没有 alt 文本  // 不描述图片内容
Optimaler Alt-Text:
- Prägnant, aber beschreibend
- Beschreiben Sie den Hauptinhalt und den Zweck des Bildes.
- Vermeide redundante Wörter wie 'Bild', 'Foto' usw.
- Für dekorative Bilder kannst du leeren Alt-Text verwenden.
- Berücksichtige den Kontext und gib aussagekräftige Informationen an.
Bildgrößenkontrolle (HTML-Methode)
Standard-Markdown unterstützt keine direkte Steuerung der Bildgröße, aber du kannst HTML-Tags verwenden.
Verwendung des HTML-img-Tags:
<img src="image.jpg.html" alt="描述文字" width="300" height="200"> <img src="image.jpg.html" alt="描述文字" width="50%"> <img src="image.jpg.html" alt="描述文字" style="width: 300px; height: auto;">
Responsive Bilder:
<img src="image.jpg.html" alt="描述文字" style="max-width: 100%; height: auto;">
Bildausrichtung:
<!-- 居中对齐 --> <div align="center"> <img src="image.jpg.html" alt="居中图片" width="400"> </div> <!-- 左对齐(默认) --> <img src="image.jpg.html" alt="左对齐图片" style="float: left; margin-right: 20px;"> <!-- 右对齐 --> <img src="image.jpg.html" alt="右对齐图片" style="float: right; margin-left: 20px;">
Fortgeschrittene Verwendung von Links und Bildern
Bild-Link-Kombinationen
Verwende ein Bild als klickbares Element für einen Link.
Grundlegende Syntax:
[](链接URL)
Praktische Beispiele:
[](https://github.com/username/project) [](https://example.com "点击访问官网")
Häufige Anwendungsfälle:
<!-- 项目徽章 --> [](https://travis-ci.org/user/repo) [](https://opensource.org/licenses/MIT) <!-- 应用商店下载 --> [](https://apps.apple.com/app/your-app) [](https://play.google.com/store/apps/details?id=com.yourapp)
Relative Pfade vs. absolute Pfade
Vorteile relativer Pfade:
<!-- 项目结构 -->
project/
├── README.md
├── docs/
│ ├── guide.md
│ └── images/
│ └── screenshot.png
└── assets/
└── logo.png
<!-- 在 README.md 中 -->

<!-- 在 docs/guide.md 中 -->


Vorschläge zur Pfadplanung:
- Erstellen Sie einen einheitlichen Ressourcenordner im Stammverzeichnis des Projekts.
- Verwenden Sie beschreibende Ordnernamen.
- Sorgen Sie für Konsistenz in der Pfadstruktur.
- Berücksichtigen Sie die Pfadregeln von Static-Site-Generatoren.
Bildzentrierung und -ausrichtung
Methode 1: HTML + CSS
<div style="text-align: center;"> <img src="image.jpg.html" alt="居中图片" style="max-width: 100%;"> </div>
Methode 2: Verwenden von HTML-Ausrichtungsattributen
<p align="center"> <img src="image.jpg.html" alt="居中图片" width="400"> </p>
Methode 3: Erstellen einer Bildergalerie
<div style="display: flex; justify-content: space-around; flex-wrap: wrap;"> <img src="image1.jpg.html" alt="图片1" style="width: 30%; margin: 10px;"> <img src="image2.jpg.html" alt="图片2" style="width: 30%; margin: 10px;"> <img src="image3.jpg.html" alt="图片3" style="width: 30%; margin: 10px;"> </div>
Praktische Vorlage zur Bildanzeige:
## 产品展示
### 主要功能
<table>
<tr>
<td align="center">
<img src="./images/feature1.png.html" width="200" alt="功能1">
<br>
<strong>智能识别</strong>
<br>
<sub>AI驱动的图像识别技术</sub>
</td>
<td align="center">
<img src="./images/feature2.png.html" width="200" alt="功能2">
<br>
<strong>快速处理</strong>
<br>
<sub>毫秒级响应速度</sub>
</td>
</tr>
</table>
### 界面预览
| 移动端 | 桌面端 |
|:---:|:---:|
|  |  |
| 响应式设计,完美适配 | 大屏体验,功能齐全 |
Vorschläge zur Leistungsoptimierung:
- Bildgröße und -format optimieren (WebP > PNG > JPG)
- Verwenden Sie passende Bildabmessungen, vermeiden Sie das Skalieren von Bildern auf der Webseite.
- Erwägen Sie die Verwendung von Bildkomprimierungswerkzeugen.
- Bereiten Sie verschiedene Bildgrößen für verschiedene Geräte vor.
Fehlerbehebung bei Links und Bildern
Häufige Probleme und Lösungen
- Link kann nicht angeklickt werden: Überprüfen Sie das Syntaxformat, stellen Sie sicher, dass eckige Klammern und runde Klammern korrekt gepaart sind.
- Bild wird nicht angezeigt: Überprüfen Sie den Bildpfad und ob die Datei existiert.
- Bild zu groß: Verwenden Sie HTML, um die Größe zu steuern, oder optimieren Sie die Bilddatei.
- Link in einem neuen Fenster öffnen: HTML<a target="_blank">-Tag verwenden
Debugging-Tipps:
<!-- 测试链接是否有效 --> 测试链接:[点击测试](https://httpbin.org/get) <!-- 测试图片路径 -->  <!-- 如果不显示,尝试绝对路径或检查文件名大小写 -->
Durch die Beherrschung der verschiedenen Verwendungen von Links und Bildern können Sie Markdown-Dokumente erstellen, die inhaltlich reich und klar in der Navigation sind. Diese Fähigkeiten sind sehr wichtig für das Schreiben technischer Dokumentationen, Projektbeschreibungen und Online-Inhalte.
Andere Erweiterungen