Uso avanzado de Markdown

Esta sección amplía la información básica ofrecida en la sección titulada 'Mejora del texto con Markdown' para proporcionar a quienes lo requieran la información necesaria para sacar el máximo partido de Markdown. Si no es su caso, o no necesita los formatos que se muestran más abajo, puede pasar por alto esta sección y regresar en caso necesario.

Saltos de línea

En algunos textos, e.g. poesía, a menudo es preciso insertar saltos de línea. Hacerlo pulsando la tecla de retorno no producirá el efecto deseado toda vez que por defecto las líneas se juntan para crear un párrafo.

Si, como el Griego afirma en el Cratilo,
El nombre es arquetipo de la cosa,
En las letras de 'rosa' está la rosa,
Y todo el Nilo en la palabra 'Nilo'.

En las líneas anteriores, si se utiliza la tecla ENTER para insertar saltos de línea, se producirá el efecto que se ve a continuación, de suerte que los saltos de línea son pasados por alto:

Si, como el Griego afirma en el Cratilo, El nombre es arquetipo de la cosa, En las letras de 'rosa' está la rosa, Y todo el Nilo en la palabra 'Nilo'.

Pero si al final de cada línea pulsamos dos espacios, forzaremos un salto de línea como aparece a continuación:

Si, como el Griego afirma en el Cratilo,
El nombre es arquetipo de la cosa,
En las letras de 'rosa' está la rosa,
Y todo el Nilo en la palabra 'Nilo'.

Reglas horizontales

Podemos crear reglas horizontales escribiendo tres o más asteriscos (*), guiones (-) o guiones bajos (_) en una línea.

Así funciona:

***

pero usted puede añadir espacios o caracteres adicionales para conseguir un salto de sección en la ventana de edición de texto, e.g.:

* * * * *

-------------------------

_ _ _ _ _

Todos estos métodos conducen al mismo resultado:


Imágenes enlazadas

El documento "Mejora del texto con Markdown" proporciona instrucciones para crear enlaces web y para insertar imágenes. Puede no resultar obvio que es posible combinarlos para crear imágenes que son al mismo tiempo enlaces sobre los que se puede hacer clic.

[motor de búsqueda google][google]

![logo de google][logo]

Sobre esta línea aparece un enlace web y una imagen estándar. Colocando la imagen en el lugar en que debería estar el texto de enlace, se consigue esto:

[![the google logo][logo]][google]

[![logo de google][logo]][google]

La línea superior junto con las siguientes definiciones del enlace en cualquier lugar del documento

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "clic para visitar Google.com"

se combinan para producir el siguiente enlace a la imagen sobre el que se puede hacer clic (apareciendo una indicación cuando pasamos el ratón sobre él):

el logo de google

Esta técnica podría resultar útil, pongamos por caso, si utilizamos pequeñas imágenes en miniatura enlazadas para descargar desde ellas las correspondientes imágenes más grandes.

HTML anidado

Si usted es hábil utilizando HTML, entonces puede haber ocasiones en que Markdown no le permitirá un contol tan exhaustivo como aquél al que está habituado. Por fortuna, Markdown está diseñado para esta eventualidad y le permite anidar HTML directamente dentro de un texto formateado en Markdown.

* <small>texto pequeño</small>
* <big>texto grande</big>

  • texto pequeño
  • texto grande

Advierta que la marca HTML coexiste con el código Markdown en las listas con topos. Esto lo libera a usted de la enojosa tarea de escribir HTML complejo para conseguir características básicas de formateado tales como párrafos y listas, en tanto que le sigue permitiendo contar con toda la potencia de HTML en situaciones específicas.

Mostrar HTML o texto pre-formateado

Si, a diferencia de la sección anterior, usted desea que el HTML que introduce aparezca exactamente como lo ha escrito en lugar de ser procesado como HTML, entonces puede comenzar cada línea con cuatro espacios.

<p>Un párrafo en <b>HTML</b> mostrado como código</p>

Esto también funciona para mostrar el código del ordenador

imprimir "Argumentos de línea de comandos: (@ARGV)\n";

Dado que este formateado con frecuencia se usa para confeccionar listas de programas de ordenador y otro texto que previsiblemente puede contener los caracteres que Markdown utiliza para indicar distintos tipos de formateado, el formato Markdown queda deshabilitado en estas líneas:

Normalmente esta palabra sería **bold**.

Para incluir algunos caracteres dentro del texto normal, véase la sección siguiente.

Uso de caracteres especiales

Si desea utilizar cualesquiera de los caracteres especiales que ponen en marcha el formateado Markdown sin que sean procesados, simplemente escriba antes una barra invertida (\). Esto se ha venido en llamar 'escape' del carácter. La barra invertida no es visible en el resultado, pero sí el carácter que le sigue, exactamenta como ha sido escrito.

\*asteriscos, sin énfasis\*

produce

*asteriscos, sin énfasis*

en lugar de

*énfasis, sin asteriscos*

lo que resulta en

énfasis, sin asteriscos

Lecturas adicionales

El sistema Markdown no es exclusivo de Moodle, sino que se utiliza en un número progresivamente creciente de herramientas de publicación web. Puede encontrar más información sobre él en http://daringfireball.net/projects/markdown/

Indice de todos los archivos de ayuda
Mostrar esta ayuda en: English