Markdown Imágenes

Las imágenes hacen que los documentos sean más dinámicos y fáciles de entender.

La sintaxis de imágenes de Markdown es simple y flexible.

El formato de la sintaxis de imágenes en Markdown es el siguiente:

![texto alternativo](ruta de imagen)
![texto alternativo](ruta de imagen "título de imagen")
  • Empieza con un signo de exclamación !
  • A continuación, un corchete que contiene el texto alternativo de la imagen
  • Después, un paréntesis que contiene la URL de la imagen y, opcionalmente, se puede añadir el texto del atributo 'title' entre comillas.

Ejemplo de ruta relativa:

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

Ejemplo de ruta absoluta:

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

Recomendaciones para el uso de rutas:

  • Se recomienda usar rutas relativas para facilitar la portabilidad del proyecto
  • Se recomienda crear una carpeta dedicada para las imágenes (como images/, assets/)
  • Usa nombres de archivo descriptivos para facilitar la gestión
  • Ten en cuenta las diferencias en los separadores de ruta entre sistemas operativos

Referenciar imágenes directamente desde Internet:

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

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

El resultado se muestra a continuación:

Por supuesto, también puedes usar variables para las URLs de las imágenes, igual que con las URLs normales:

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

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

El resultado se muestra a continuación:

Markdown no ofrece una forma de especificar el alto y el ancho de las imágenes; si lo necesitas, puedes usar la etiqueta <img> estándar de HTML.

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

El resultado se muestra a continuación:

Uso de servicios CDN:

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

Consideraciones sobre imágenes de Internet:

  • Asegura la estabilidad y accesibilidad de las URLs de las imágenes
  • Ten en cuenta los problemas de derechos de autor de las imágenes
  • Considera la velocidad de carga y el entorno de red
  • Se recomienda hacer copias de seguridad locales de las imágenes importantes

Importancia del texto alternativo (alt) en las imágenes

El texto alternativo (alt) proporciona información de respaldo cuando la imagen no se puede mostrar, y también es importante para la accesibilidad y el SEO:

Ejemplos de buenos textos alternativos:

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

Textos alternativos que se deben evitar:

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

Buenas prácticas para el texto alternativo:

  • Conciso pero descriptivo
  • Describe el contenido principal y el propósito de la imagen
  • Evita palabras redundantes como "imagen" o "foto"
  • Para imágenes decorativas, se puede usar un texto alternativo vacío
  • Ten en cuenta el contexto y proporciona información significativa

Control del tamaño de imagen (método HTML)

El Markdown estándar no permite controlar directamente el tamaño de las imágenes, pero se pueden usar etiquetas HTML.

Usar la etiqueta img de HTML:

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

Imágenes responsivas:

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

Alineación de imágenes:

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

Usos avanzados de enlaces e imágenes

Combinación de imagen y enlace

Usar la imagen como elemento clicable de un enlace.

Sintaxis básica:

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

Ejemplo práctico:

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

Casos de uso comunes:

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

Rutas relativas y rutas absolutas

Ventajas de las rutas relativas:

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

Recomendaciones para la planificación de rutas:

  • Crea una carpeta de recursos unificada en el directorio raíz del proyecto
  • Usa nombres de carpeta descriptivos
  • Mantén la coherencia en la estructura de rutas
  • Ten en cuenta las reglas de rutas de los generadores de sitios estáticos

Centrado y alineación de imágenes

Método 1: HTML + CSS

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

Método 2: Usar atributos de alineación de HTML

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

Método 3: Crear una galería de imágenes

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

Plantilla práctica para mostrar imágenes:

## 产品展示

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

Recomendaciones para optimizar el rendimiento:

  • Optimiza el tamaño y formato de las imágenes (WebP > PNG > JPG)
  • Usa dimensiones de imagen adecuadas y evita escalar imágenes grandes en la página web
  • Considera usar herramientas de compresión de imágenes
  • Prepara imágenes de diferentes tamaños para diferentes dispositivos

Solución de problemas con enlaces e imágenes

Problemas comunes y soluciones:

  • El enlace no se puede hacer clic: verifica el formato de sintaxis y asegúrate de que los corchetes y paréntesis estén correctamente emparejados
  • La imagen no se muestra: verifica la ruta de la imagen y que el archivo exista
  • La imagen es demasiado grande: usa HTML para controlar el tamaño u optimiza el archivo de imagen
  • Abrir el enlace en una ventana nueva: usar HTML<a target="_blank">etiqueta

Trucos de depuración:

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

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

Al dominar los distintos usos de enlaces e imágenes, puedes crear documentos Markdown con contenido rico y navegación clara. Estas habilidades son muy importantes para redactar documentación técnica, descripciones de proyectos y contenido en línea.

Otras extensiones