RicardoVelaC / MarkdownNotes

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Markdown

logo-md


¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado en 2004 con el que puedes agregar formato a documentos de texto plano. 📜

La clave del diseño de**Markdown** es la facilidad de lectura, que hace que el lenguaje sea fácilmente interpretado.

Cuando creas documentos Markdown, agregas el formato escribiendo los símbolos que conforman la sintaxis de Markdown, sin que exista una interfaz gráfica. Puedes agregar elementos en formato Markdown a cualquier archivo de texto plano mediante cualquier editor de texto. Aunque también puedes utilizar editores específicos para escribir y visualizar el resultado a la vez.

Markdown ha sido diseñado para que el texto también resulte legible sin ser renderizado.

Más adelante, cuando el documento se procese mediante una herramienta compatible, el texto junto con la sintaxis Markdown se exportará a otro tipo de archivo, que podrá ser de algún formato como por ejemplo HTML o PDF.


Ejemplos de sintaxis

Common MarkDown

Saltos de línea

Los saltos de línea se generan cuando se encuentran dos espacios juntos:

"Quien fue a Santiago,  
perdió su clase de redes"

Citas

Para citar solo es necesario escribir una cuña > antes del texto:

La vida es muy corta para aprender alemán.

-Tad Marburg

> La vida es muy corta para aprender alemán.
>> -Tad Marburg

Encabezados

Se generan cuando se encuentra una almohadilla antes del texto:

# Encabezado nivel h1
## Encabezado nivel h2
### Encabezado nivel h3
#### Encabezado nivel h4
##### Encabezado nivel h5
###### Encabezado nivel h6

También los podemos crear añadiendo una línea de = para los de nivel 1 y - para los de nivel 2:

Encabezado h1
===============
Encabezado h2
---------------

![h1h2]


Código

Se utilizan tres acentos graves para identificar código, seguidos del leguaje de programación para identificar el marcado correcto del mismo:

```html
<!DOCTYPE html>
<html>
<head>
  <title>Tutorial Markdown</title>
</head>
</html>
```

También podemos añadir código como <html> dentro de una línea utilizando un solo acento grave para marcarlo:

`<html>`

Separadores

Para insertar una línea separadora podemos incluir *** o --- y obtendríamos:



Formatos

Podemos incluir cursivas, negritas, ambas, texto tachado e incluso todo junto

|                                Código Markdown                                |
| :---------------------------------------------------------------------------: |
|                                                                               |
|                                                                               |
|                                   _cursiva_                                   |
|                                                                               |
|                                  **negrita**                                  |
|                                                                               |
|                            **_cursiva y negrita_**                            |
|                                                                               |
|                                  ~~tachado~~                                  |
|                                                                               |
|                            ~~*cursiva y tachado*~~                            |
|                                                                               |
|                            ~~**negrita tachado**~~                            |
|                                                                               |
|                     ~~**_cursiva, negrita y tachado_**~~                      |
|                                                                               |
|                                                                               |
| _____________________________________________________________________________ |

Podemos utilzar * o _ indistintamente siendo siempre dobles para negrita y simples para cursiva por ejemplo:

Esto es un texto en negrita y esto también lo es

Esto es un texto en cursiva y esto también lo es

MD Code:

**Esto es un texto en negrita** __y esto también lo es__

*Esto es un texto en cursiva* _y esto también lo es_

cursiva negrita negrita y cursiva tachado

|                                Código Markdown                                |
| :---------------------------------------------------------------------------: |
|                                                                               |
|         *cursiva*  **negrita**  **_negrita y cursiva_**  ~~tachado~~          |
|                                                                               |
|         _cursiva_  __negrita__  __*negrita y cursiva*__  ~~tachado~~          |
|                                                                               |
| _____________________________________________________________________________ |

Listas

Desordenadas

  • Puedes crear listas con los símbolos +, -, o *
  • Y también sublistas agregando 2 espacios:
    • Cada marcador creará un nuevo elemento:
      • No importa que marcador
      • utilices por que solo
      • tiene encuenta
      • los subniveles
  • Es muy fácil
<!-- Código Markdown -->
  + Puedes crear listas con los símbolos +, -, o *
  + Y también sublistas agregando 2 espacios:
    - Cada marcador creará un nuevo elemento:
      * No importa que marcador
      + utilices por que solo
      - tiene encuenta 
      - los subniveles
  + Es muy fácil

Ordenadas

  1. Elemento 1
  2. Elemento 2
  3. Elemento 3
  4. Elemento 4
    • Sub-elemento 4.1
    • Sub-elemento 4.2
      1. Sub-elemento 4.2.1
      2. Sub-elemento 4.2.2
  5. Elemento 5
<!-- Código Markdown -->
1. Elemento 1
2. Elemento 2
3. Elemento 3
4. Elemento 4
   - Sub-elemento 4.1
   - Sub-elemento 4.2
      1. Sub-elemento 4.2.1
      2. Sub-elemento 4.2.2
5. Elemento 5

Tablas

Para agregar tablas Markdown debes definir las cabeceras de columna mediante al menos tres guiones --- que se situarán por debajo del texto de la cabecera. Para separar las diferentes cabeceras tendrás que usar un símbolo de tubería |:

| Cabecera 1 | Cabecera 2 |
| ---------- | ---------- |
| Elem 1, 1  | Elem 1, 2  |
| Elem 1, 2  | Elem 2, 2  |

Cuyo resultado obtendríamos

Cabecera 1 Cabecera 2
Elem 1, 1 Elem 1, 2
Elem 1, 2 Elem 2, 2

Para crear la estructura de la tabla podemos usar un generador como este:

https://www.tablesgenerator.com/markdown_tables


Enlaces

Muchos de los procesadores de MD convertirán automáticamente el texto https://www.google.es en un hipervínculo para conseguir mostarlo como texto tenemos que indicarlo expresamente https://www.google.es con la siguiente notación

`https://www.google.es`

Si por el contrario pretendemos enlazar una palabra o frase concreta cualquier otro sitio web debemos seguir la siguiente estructura

https://www.wikipedia.com
Wikipedia

[https://www.wikipedia.com](https://www.wikipedia.com)  
[Wikipedia](https://www.wikipedia.com)

Imágenes


Referencias


Listas de tareas

También podemos crear una lista de tareas en la que nos permite marcar determinados elementos

  • Primera tarea
  • Segunda tarea
  • Tercera tarea
- [x] Primera tarea
- [ ] Segunda tarea
- [ ] Tercera tarea

Emojis

Existen dos formas de añadir emojis a nuestros documentos .md

  1. Copiando y pegando el emoji

    • Si entramos en emojipedia podemos copiar directamente el emoji que deseemos incluir en nuestro documento .md
      • 🎵🎷🎹🔥
  2. *Usando los shortcodes

    • A cada emoji le corresponde un código para su rápida localización este código se llama shortcode y comienzan y terminan con dos puntos por ejemplo :emoji:

      Me encanta tu sonrisa 😄, pero eres más lento que una tortuga 🐢.

      Me encanta tu sonrisa :smile:, pero eres más lento que una tortuga :turtle:.

    Podemos encontrar una lista completa con todos los shortcodes en GitHub

  3. *Usando solo texto :) y obtendremos :)

*Este método no funciona en todos los procesadores de MD


Nota al pie

Abreviaturas

La especificación HTML es mantenida por el W3C.

*[HTML]: Hyper Text Markup Language
*[W3C]: World Wide Web Consortium


About

License:The Unlicense