Изображения в Markdown

Изображения могут сделать документы более наглядными и понятными.

Синтаксис изображений в Markdown прост и гибок.

Формат синтаксиса изображений Markdown выглядит следующим образом:

![Alternative text](图片路径)
![Alternative text](图片路径 "Image title")
  • Начните с восклицательного знака !
  • Затем квадратную скобку, внутри которой вы размещаете альтернативный текст для изображения.
  • Затем обычная круглая скобка, внутри которой вы указываете URL изображения, и наконец вы можете при желании добавить текст для атрибута 'title', заключённый в кавычки.

Пример относительного пути:

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

Пример абсолютного пути:

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

Рекомендации по использованию путей:

  • Рекомендуется использовать относительные пути для упрощения переносимости проекта.
  • Рекомендуется создать отдельную папку для изображений (например, images/, assets/).
  • Используйте осмысленные имена файлов для удобства управления.
  • Учитывайте различия в разделителях путей в разных операционных системах.

Прямое указание онлайн-изображений:

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

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

Отображаемый результат выглядит следующим образом:

Конечно, вы также можете использовать переменные для URL изображений, точно так же, как и для URL:

这个链接用 1 作为网址变量 [EXAMPLE][1].
然后在文档的结尾为变量赋值(网址)

[1]: /static.jyshare.com/images/example-logo.png

Отображаемый результат выглядит следующим образом:

В Markdown пока нет способа указать высоту и ширину изображений. Если это необходимо, вы можете использовать обычный тег <img>.

<img src="../static.jyshare.com/images/example-logo.png?v=2" width="50%">

Отображаемый результат выглядит следующим образом:

Использование сервисов CDN:

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

Что следует учитывать при работе с изображениями в интернете:

  • Убедитесь в стабильности и доступности URL изображения.
  • Учитывайте вопросы авторского права на изображения.
  • Учитывайте скорость загрузки и сетевое окружение.
  • Рекомендуется создавать локальные резервные копии важных изображений.

Важность альтернативного текста изображения

Альтернативный текст (alt-текст) предоставляет альтернативную информацию, когда изображение не может быть отображено, а также важен для доступности и SEO:

Пример хорошего альтернативного текста:

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

Альтернативный текст, которого следует избегать:

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

Рекомендации по составлению альтернативного текста:

  • Краткий, но информативный
  • Опишите основное содержание и назначение изображения.
  • Избегайте избыточных слов, таких как «изображение», «фото» и т. п.
  • Для декоративных изображений можно использовать пустой alt-текст.
  • Учитывайте контекст и предоставляйте содержательную информацию.

Управление размером изображения (метод HTML)

Стандартный Markdown не поддерживает прямое управление размером изображения, но можно использовать HTML-теги.

Использование HTML-тега img:

<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;">

Адаптивные изображения:

<img src="image.jpg.html" alt="描述文字" style="max-width: 100%; height: auto;">

Выравнивание изображения:

<!-- 居中对齐 -->
<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;">

Расширенное использование ссылок и изображений

Комбинации изображений и ссылок

Используйте изображение как кликабельный элемент для ссылки.

Базовый синтаксис:

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

Практические примеры:

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

Типичные случаи использования:

<!-- 项目徽章 -->
[![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)

Относительные пути против абсолютных путей

Преимущества относительных путей:

<!-- 项目结构 -->
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)

Рекомендации по планированию путей:

  • Создайте единую папку ресурсов в корневом каталоге проекта.
  • Используйте описательные имена папок.
  • Поддерживайте единообразие структуры путей.
  • Учитывайте правила путей генераторов статических сайтов.

Центрирование и выравнивание изображений

Метод 1: HTML + CSS

<div style="text-align: center;">
  <img src="image.jpg.html" alt="居中图片" style="max-width: 100%;">
</div>

Метод 2: Использование атрибутов выравнивания HTML

<p align="center">
  <img src="image.jpg.html" alt="居中图片" width="400">
</p>

Метод 3: Создание галереи изображений

<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>

Практический шаблон отображения изображений:

## 产品展示

### 主要功能
<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) |
| 响应式设计,完美适配 | 大屏体验,功能齐全 |

Рекомендации по оптимизации производительности:

  • Оптимизируйте размер и формат изображения (WebP > PNG > JPG)
  • Используйте подходящие размеры изображений, избегайте масштабирования больших изображений на веб-странице.
  • Рассмотрите использование инструментов сжатия изображений.
  • Подготавливайте разные размеры изображений для разных устройств.

Устранение неполадок со ссылками и изображениями

Типичные проблемы и решения:

  • Ссылка не нажимается: проверьте синтаксис, убедитесь, что квадратные и круглые скобки правильно соединены в пары.
  • Изображение не отображается: проверьте путь к изображению и убедитесь, что файл существует.
  • Изображение слишком большое: используйте HTML для управления размером или оптимизируйте файл изображения.
  • Открытие ссылки в новом окне: используйте HTML-тег<a target="_blank">tag

Советы по отладке:

<!-- 测试链接是否有效 -->
测试链接:[点击测试](https://httpbin.org/get)

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

Освоив различные способы использования ссылок и изображений, вы сможете создавать документы Markdown, богатые содержимым и с понятной навигацией. Эти навыки очень важны для написания технической документации, описаний проектов и онлайн-контента.

Другие расширения