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:
 
- 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:
  
Ejemplo de ruta absoluta:
 
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:
 
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:
 
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:
  
Textos alternativos que se deben evitar:
 // 太简单,没有描述性  // 完全没有 alt 文本  // 不描述图片内容
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:
[](链接URL)
Ejemplo práctico:
[](https://github.com/username/project) [](https://example.com "点击访问官网")
Casos de uso comunes:
<!-- 项目徽章 --> [](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)
Rutas relativas y rutas absolutas
Ventajas de las rutas relativas:
<!-- 项目结构 -->
project/
├── README.md
├── docs/
│ ├── guide.md
│ └── images/
│ └── screenshot.png
└── assets/
└── logo.png
<!-- 在 README.md 中 -->

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


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>
### 界面预览
| 移动端 | 桌面端 |
|:---:|:---:|
|  |  |
| 响应式设计,完美适配 | 大屏体验,功能齐全 |
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) <!-- 测试图片路径 -->  <!-- 如果不显示,尝试绝对路径或检查文件名大小写 -->
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