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:

![Alternative text](图片路径)
![Alternative text](图片路径 "Image title")
  • 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:

![项目截图](./images/screenshot.png)
![用户界面](../assets/ui-demo.jpg "用户界面演示")
![图标](images/icon.svg "应用图标")

Beispiel für absoluten Pfad:

![本地图片](/Users/username/Documents/image.png)
![系统截图](C:\Users\username\Pictures\screenshot.png)

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:

![EXAMPLE 图标](/static.jyshare.com/images/example-logo.png?v=2)

![EXAMPLE 图标](/static.jyshare.com/images/example-logo.png?v=2 "EXAMPLE")

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:

![示例图片](https://cdn.jsdelivr.net/gh/user/repo/image.png)
![Unsplash 图片](https://images.unsplash.com/photo-1506905925346-21bda4d32df4)

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:

![苹果公司总部大楼外观,现代玻璃幕墙建筑](./images/apple-headquarters.jpg)
![网站流量统计图表,显示过去六个月的访问量呈上升趋势](./charts/traffic-stats.png)
![用户登录界面,包含用户名和密码输入框](./screenshots/login-page.png)

Zu vermeidender Alt-Text:

![图片](image.jpg)  // 太简单,没有描述性
![](image.jpg)      // 完全没有 alt 文本
![点击这里](image.jpg)  // 不描述图片内容

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:

[![图片alt文本](图片URL)](链接URL)

Praktische Beispiele:

[![GitHub项目截图](./images/project-screenshot.png)](https://github.com/username/project)
[![访问官网](https://example.com/logo.png)](https://example.com "点击访问官网")

Häufige Anwendungsfälle:

<!-- 项目徽章 -->
[![Build Status](https://travis-ci.org/user/repo.svg?branch=master)](https://travis-ci.org/user/repo)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

<!-- 应用商店下载 -->
[![App Store](./images/app-store-badge.png)](https://apps.apple.com/app/your-app)
[![Google Play](./images/google-play-badge.png)](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 中 -->
![Logo](./assets/logo.png)

<!-- 在 docs/guide.md 中 -->
![Screenshot](./images/screenshot.png)
![Logo](../assets/logo.png)

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>

### 界面预览
| 移动端 | 桌面端 |
|:---:|:---:|
| ![移动界面](./images/mobile.png) | ![桌面界面](./images/desktop.png) |
| 响应式设计,完美适配 | 大屏体验,功能齐全 |

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)

<!-- 测试图片路径 -->
![测试图片](./images/test.png)
<!-- 如果不显示,尝试绝对路径或检查文件名大小写 -->

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