Tutorial de Markdown en Jupyter Notebook

Títulos

Los títulos comienzan con "#", es decir, el símbolo de almohadilla seguido de un espacio, y hay seis títulos: el título más grande solo utiliza un símbolo de almohadilla y los títulos más pequeños utilizan seis símbolos de almohadilla.

# (Encabezado 1, título)

## (Encabezado 2, títulos principales)

### (Encabezado 3, subtítulos)

#### (Encabezado 4)

##### (Encabezado 5)

###### (Encabezado 6)``

Alternativamente, los encabezamientos pueden comenzar con etiquetas de marcado, es decir, de h1 a h6 con las siguientes sintaxis.

<h1>Encabezado 1,título<h1>
<h2>Encabezado 2,títulos principales<h2>
<h3>Encabezado 3,subtítulos<h3>
<h4>Encabezado 4<h4>
<h5>Encabezado 5<h5>
<h6>Encabezado 6<h6>

Las dos sintaxis anteriores pueden mostrar los encabezados de h1 a h6 tras hacer clic en "Ejecutar" en la barra de herramientas.

Comillas en bloque

Las comillas de bloque pueden contener grandes trozos de texto y suelen ir sangradas. Se pueden obtener utilizando el símbolo Markdown '>' o con <blockquote>texto para comillas en bloque</blockquote>.

• >Tiene buena pinta.
• <blockquote>Tiene buena pinta.</blockquote>

Ambas sintaxis pueden mostrar el texto en forma sangrada después de hacer clic en "Ejecutar" en la barra de herramientas.

Sección de código

La sección de código es la parte que especifica el código de diferentes lenguajes de programación y puede representarse donde el código inline comienza con ' `el código inline va aquí` ' con tildes a su alrededor, pero el bloque de código comienza con tres tildes ' ``el código de línea de bloque va aquí`` '. Además, la etiqueta Markup para una sección de código es ' <code>el código va aquí<code> '.

El ejemplo de código en línea se muestra a continuación:
`x =5`

Puedes ver que, tras hacer clic en "Ejecutar", el código en línea se muestra resaltando el código.

A continuación se dan ejemplos de secciones de código:

• Utilizar Markdown
```Python

str = "Esto es código a nivel de bloque"

print(str)

```
• Uso de etiquetas de marcado
<code>Python

str = "Este es un código a nivel de bloque"

print(str)

</code>

Utilizando Markdown, puedes obtener el resaltado sintáctico del código si el nombre del lenguaje de programación se menciona después de las tres marcas "```" y el ejemplo se da a continuación:

Usando Markdown, no obtendrás resaltado de sintaxis, pero el código sí se resalta:

Símbolo matemático

El símbolo matemático en Markdown se incluye en '\$ la expresión matemática va aquí \$' encerrado en un símbolo de dólar y en Markup puedes seguir este enlace para más detalles: Operadores matemáticos. A continuación puedes ver un ejemplo de utilización de los símbolos matemáticos.

\$\sqrt{k}$

El ejemplo anterior mostrará la expresión matemática en negrita.

Salto de línea

La etiqueta de salto de línea comienza con la etiqueta <br> sin etiqueta de cierre que rompe la línea, y el resto del contenido comienza con una nueva línea con el ejemplo que se muestra a continuación.

The line breaks after using <br> br tags and it is awesome.

Después de hacer clic en "Ejecutar" en la barra de herramientas, puedes ver el salto de línea después de utilizar la etiqueta <br>. El resto del texto empieza en una línea nueva.

Texto en negrita y cursiva

Puedes utilizar etiquetas <b>, '**' es decir, 'doble asterisco' o '__' es decir, 'doble guión bajo' para obtener texto en negrita con la siguiente sintaxis.

• <b>Esto es texto en negrita</b>

• ** Esto es texto en negrita

• __ Esto es texto en negrita

Todas las sintaxis anteriores pueden mostrar texto en negrita tras pulsar "Ejecutar" en la barra de herramientas.

Puedes utilizar etiquetas <i>, '*' es decir, asterisco simple o '_' es decir, guión bajo simple para obtener el texto en cursiva con la siguiente sintaxis.

• <i>Esto es texto en cursiva </i>

• * Esto es texto en cursiva

• __ Esto es texto en cursiva

Todas las sintaxis anteriores pueden mostrar el texto en cursiva después de hacer clic en "Ejecutar" en la barra de herramientas.

Línea horizontal

Puedes obtener una línea horizontal utilizando Markdown '---' tres guiones o etiquetas Markup <hr>

Las dos sintaxis anteriores harán que la línea horizontal cruce de un extremo a otro extremo después de pulsar "Ejecutar".

Lista ordenada

La Lista ordenada es la lista numerada que se obtiene comenzando con la etiqueta <ol> y terminando con la etiqueta </ol> con el elemento deseado entre las etiquetas <li> y </li>. La etiqueta, es decir, "ol", es la forma abreviada de una lista ordenada y "li" es la forma abreviada del elemento de la lista. Por ejemplo, puedes ver a continuación la lista ordenada que contiene el artículo de la lista de la compra.

<ol>
<li>Pescado</li>
<li>Huevos</li>
<li>Queso</li>
</ol>

También puedes enumerar por '1. ', es decir, el número requerido seguido de espacio con el ejemplo que se da a continuación.

1. Pescado
2. Huevos
3. Queso

Ambas sintaxis pueden generar la lista numerada después de hacer clic en "Ejecutar" en la barra de herramientas.

Lista desordenada

La lista desordenada es una lista con viñetas que se obtiene utilizando la etiqueta <ul> y terminando con la etiqueta </ul>, mira el ejemplo siguiente:

<ul>
<li>Pescado</li>
<li>Huevos</li>
<li>Queso</li>
</ul>

Alternativamente, la lista desordenada puede empezar con el símbolo "-" con espacio, que da el símbolo del círculo negro, y también puede empezar con el símbolo "*" con espacio, que da el símbolo del cuadrado negro.

-   Pescado
-   Huevos
-   Queso

El ejemplo anterior muestra que la lista de viñetas contiene el símbolo "-" seguido de un espacio con los elementos que da el símbolo del círculo negro.

Las dos sintaxis anteriores pueden dar el mismo resultado siguiente, en el que los elementos de la lista aparecen en el círculo negro, después de hacer clic en "Ejecutar" en la barra de herramientas.

Enlace interno y externo

El enlace interno en Markdown comienza con la etiqueta <a> con un identificador único definido por el atributo <id> que puede enlazarse en el cuaderno con el ejemplo siguiente:

<a id = "division_ID "el texto va aquí></a>

Además, el ID definido anteriormente se puede vincular a la sección del cuaderno siguiendo el código que hace que se pueda hacer clic en el enlace.

[Título de la sección](#ID_división)

El ejemplo de lo anterior se puede ver a continuación, donde el id definido se vincula con la sección y el enlace clicable que se obtiene tras hacer clic en "Ejecutar" en la barra de herramientas.

Un enlace externo en Markdown comienza con <a> y termina con la etiqueta <a>, es decir, <a> significa ancla, que define el enlace, y tiene el atributo "href", también llamado hiperreferencia, que contiene la dirección de destino del enlace o URL, y los textos entre las etiquetas son visibles y se puede hacer clic en ellos para abrir la dirección de destino, como se muestra a continuación.

<a> href="https://www.google.com">Enlace a Google</a>

También podría empezar con __[enlace de texto](URL del sitio)__ donde el doble guión bajo está a ambos lados, con el enlace de texto entre corchetes y la URL del sitio entre paréntesis seguida de la URL.

Enlace a Google

Las dos sintaxis anteriores pueden dar el mismo resultado a continuación, donde el texto clicable y subrayado puede llevar a una nueva página después de hacer clic en "Ejecutar" en la barra de herramientas.

Tabla

La tabla contiene la información en filas y columnas y se construye mediante la combinación de "|", es decir, "barra vertical", para separar cada columna y "-", es decir, símbolo de guión, para crear la cabecera, donde la línea en blanco, es decir, una combinación de barra vertical y guiones para dar el formato de tabla.

Además, puedes variar las celdas al alinearlas aproximadamente con las columnas, y el bloc de notas redimensionará automáticamente el contenido de la celda dada.

|Name|Address|Salary| |-----|-------|------| |Hanna|Brisbane|4000| |Adam|Sydney|5000|

Alternativamente, el Markdown se puede utilizar para construir tablas donde <table> se utiliza para definir una tabla con su anchura en porcentajes.<tr> establece la fila de la tabla que da la negrita con el texto centrado junto con el encabezado de la tabla se describe por <th> está en la parte superior de la tabla con las otras entradas en la tabla se establecen por el <td> es decir, la etiqueta de datos de la tabla.

<table style="width:20%">
<tr>
<th><Nombre></th>
<th><Dirección></th>
<th><Salario></th>
</tr>

<tr>
<td><Hanna></td>
<td><Brisbane></td>
<td><4000></td>
</tr>

<tr>
<td><Adam></td>
<td><Sydney></td>
<td><5000></td>
</tr>
</table>

Las dos sintaxis anteriores pueden dar el mismo resultado después de hacer clic en "Ejecutar" en la barra de herramientas.

Imágenes

Puedes insertar una imagen desde la barra de herramientas eligiendo "Insertar imagen" en el menú Edición y puedes buscar la imagen deseada como se muestra a continuación.

La imagen puede contener la etiqueta Markdown <img> con fuente, es decir, src como atributo que consiste en el enlace a la imagen con propiedades opcionales como anchura y altura, y el ejemplo de ello es el siguiente.

<img> <src="https://i.imgur.com/WWrydEh.png" width ="500" height=500 >

Los dos procesos anteriores pueden renderizar la misma imagen después de hacer clic en "Ejecutar" en la barra de herramientas.

Conclusión

En este tutorial, has aprendido sobre las diferentes etiquetas Markup, definidas por el lenguaje Markup, y también sobre la sintaxis relacionada con las celdas Markdown específicas del Jupyter Notebook, que se utiliza junto con el código para describir el contenido de forma más eficaz.

Si quieres saber más sobre Markdown, echa un vistazo a la guía de Markdown.