From 94dadbf1a4da23922d6a6a401ef07368612aca88 Mon Sep 17 00:00:00 2001 From: MANUEL SALDAGNA Date: Thu, 17 Apr 2025 00:06:47 +0000 Subject: [PATCH] Actualizar README.md --- README.md | 144 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 142 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b9450af..afc143a 100644 --- a/README.md +++ b/README.md @@ -342,8 +342,148 @@ imagen_banner.png 1920x658
-imagen_banner.jpg 1920x658 -

TÍTULO

sub_título

+
+

Markdown

no requiere de software especializado

+Escribir archivos Markdown es bastante sencillo y no requiere de software especializado. ¡Es una habilidad muy útil para crear documentos con formato de manera rápida y legible! +La clave para "escribir" archivos Markdown es utilizar un editor de texto plano. Esto significa cualquier aplicación que te permita escribir texto sin aplicar formato especial (como negritas, cursivas, etc.) directamente en el texto. Algunos ejemplos comunes son: + +En Windows: Notepad (Bloc de notas) +En macOS: TextEdit (Asegúrate de configurarlo para texto plano en Preferencias > Abrir y Guardar > Formato: Texto sin formato) +En Linux: gedit, nano, vim, etc. +Editores de código: Visual Studio Code (VS Code), Sublime Text, Atom (suelen tener resaltado de sintaxis para Markdown que facilita la lectura) +Editores Markdown dedicados: Typora, Obsidian, iA Writer (ofrecen una vista previa en tiempo real del formato) +Editores online: Dillinger, StackEdit +El proceso básico es: + +Abrir un editor de texto plano. +Escribir tu contenido utilizando la sintaxis Markdown. (Te la explico en la siguiente sección). +Guardar el archivo con la extensión .md o .markdown. Por ejemplo, mi_documento.md. +¡Eso es todo! El archivo en sí es solo texto plano con ciertas convenciones que los programas o plataformas que soportan Markdown interpretan para mostrar el formato deseado. + +¿Qué necesito saber? (Sintaxis Markdown básica) + +La belleza de Markdown radica en su simplicidad. Aquí tienes los elementos más comunes que necesitas conocer: + +Encabezados: + +Para crear encabezados, utiliza el símbolo # al principio de la línea, seguido de un espacio y el texto del encabezado. La cantidad de # indica el nivel del encabezado (de h1 a h6). + +Markdown + +# Encabezado de nivel 1 +## Encabezado de nivel 2 +### Encabezado de nivel 3 +Énfasis (Negrita y Cursiva): + +Cursiva: Rodea el texto con un asterisco simple (*) o un guion bajo simple (_). + +Markdown + +*Este texto estará en cursiva* +_Este texto también estará en cursiva_ +Negrita: Rodea el texto con dos asteriscos (**) o dos guiones bajos (__). + +Markdown + +**Este texto estará en negrita** +__Este texto también estará en negrita__ +Negrita y Cursiva: Rodea el texto con tres asteriscos (***) o tres guiones bajos (___). + +Markdown + +***Este texto estará en negrita y cursiva*** +___Este texto también estará en negrita y cursiva___ +Listas: + +Listas no ordenadas (con viñetas): Utiliza un asterisco (*), un guion (-) o un signo más (+) seguido de un espacio al principio de cada línea. + +Markdown + +* Elemento 1 +* Elemento 2 +- Otro elemento ++ Un elemento más +Listas ordenadas (numeradas): Utiliza números seguidos de un punto (.) y un espacio al principio de cada línea. + +Markdown + +1. Primer elemento +2. Segundo elemento +3. Tercer elemento +Enlaces: + +Para crear un enlace, utiliza corchetes [] para el texto del enlace y paréntesis () para la URL. + +Markdown + +[Texto del enlace](https://www.ejemplo.com) +Imágenes: + +La sintaxis para imágenes es similar a la de los enlaces, pero con un signo de exclamación (!) al principio. + +Markdown + +![Texto alternativo de la imagen](ruta/a/la/imagen.jpg) +Saltos de línea: + +Para crear un salto de línea simple dentro de un párrafo, puedes dejar dos espacios al final de la línea anterior antes de presionar Enter. +Para crear párrafos separados, deja una línea en blanco entre ellos. +Líneas horizontales: + +Puedes crear una línea horizontal utilizando tres o más asteriscos (***), guiones (---) o guiones bajos (___) en una línea separada. + +Markdown + +*** +--- +___ +Bloques de código: + +Para crear bloques de código, puedes encerrar el código entre tres comillas invertidas (backticks) ```. Opcionalmente, puedes especificar el lenguaje después de las primeras tres comillas para el resaltado de sintaxis. + +Markdown + +```python +print("Hola mundo!") +JavaScript + +console.log("¡Hola!"); +Para código en línea (dentro de un párrafo), utiliza una sola comilla invertida ` alrededor del código. + +Markdown + +La función `print()` en Python se usa para mostrar texto. +Tablas: + +Las tablas se crean utilizando guiones (-) para separar la fila del encabezado de las filas de datos, y barras verticales (|) para separar las columnas. + +Markdown + +| Columna 1 | Columna 2 | +| --------- | --------- | +| Dato 1 | Dato 2 | +| Otro dato | Más datos | +Citas en bloque: + +Utiliza el símbolo > seguido de un espacio al principio de la línea para crear una cita en bloque. + +Markdown + +> Este es un texto citado. +> Puede ocupar varias líneas. +Carácter de escape: + +Si necesitas usar alguno de los caracteres especiales de Markdown (como *, #, _, etc.) literalmente, puedes escaparlos con una barra invertida (\). + +Markdown + +\* Este asterisco no iniciará cursiva \* +¿Qué más necesito saber? + +Visualización: Aunque los archivos Markdown son texto plano, necesitas un procesador de Markdown para verlos con el formato aplicado. Muchos sitios web (como GitHub, Reddit), aplicaciones de toma de notas (como Obsidian, Evernote), y editores de texto (como VS Code con extensiones) tienen soporte integrado para renderizar Markdown. También existen conversores online y offline que pueden transformar archivos .md a otros formatos como HTML, PDF, etc. +Variantes de Markdown: Existen algunas variaciones o extensiones de la sintaxis Markdown (como GitHub Flavored Markdown - GFM) que añaden características adicionales como listas de tareas (checkboxes), menciones de usuarios, etc. +Práctica: La mejor manera de aprender es practicar. ¡Abre un editor de texto y empieza a escribir! Experimenta con los diferentes elementos de la sintaxis para ver cómo se ven cuando se procesan. +¡Escribir en Markdown es una habilidad fundamental para cualquiera que trabaje con texto en la era digital! Es ligero, fácil de leer en su formato original y se puede convertir a muchos otros formatos.