mirror of
https://github.com/moodle/moodle.git
synced 2025-02-25 12:33:18 +01:00
759 lines
32 KiB
HTML
759 lines
32 KiB
HTML
|
<p align="center"><b>Uso del formato Markdown para escribir p<>ginas web</b></p>
|
|||
|
|
|
|||
|
|
<p>(Este texto es una copia de <a target="_blank" href="http://daringfireball.net/projects/markdown/syntax">la p<>gina de sintaxis Markdown original</a>)</p>
|
|||
|
|
|
|||
|
|
<hr />
|
|||
|
|
<div id="Main">
|
|||
|
|
|
|||
|
|
<div class="article">
|
|||
|
|
|
|||
|
|
<ul>
|
|||
|
|
<li><a href="#overview">Visi<EFBFBD>n general</a>
|
|||
|
|
<ul>
|
|||
|
|
<li><a href="#philosophy">Filosof<EFBFBD>a</a></li>
|
|||
|
|
<li><a href="#html">HTML en l<>nea</a></li>
|
|||
|
|
<li><a href="#autoescape">Escape autom<6F>tico para caracteres especiales</a></li>
|
|||
|
|
</ul></li>
|
|||
|
|
<li><a href="#block">Elementos de bloque</a>
|
|||
|
|
<ul>
|
|||
|
|
<li><a href="#p">P<EFBFBD>rrafos y saltos de l<>nea</a></li>
|
|||
|
|
<li><a href="#header">Cabeceras</a></li>
|
|||
|
|
<li><a href="#blockquote">Citas</a></li>
|
|||
|
|
<li><a href="#list">Listas</a></li>
|
|||
|
|
<li><a href="#precode">Bloques de c<>digo</a></li>
|
|||
|
|
<li><a href="#hr">Reglas horizontales</a></li>
|
|||
|
|
</ul></li>
|
|||
|
|
<li><a href="#span">Span Elements</a>
|
|||
|
|
<ul>
|
|||
|
|
<li><a href="#link">Enlaces</a></li>
|
|||
|
|
<li><a href="#em"><EFBFBD>nfasis</a></li>
|
|||
|
|
<li><a href="#code">C<EFBFBD>digo</a></li>
|
|||
|
|
<li><a href="#img">Im<EFBFBD>genes</a></li>
|
|||
|
|
</ul></li>
|
|||
|
|
<li><a href="#misc">Miscel<EFBFBD>nea</a>
|
|||
|
|
<ul>
|
|||
|
|
<li><a href="#autolink">Enlaces autom<6F>ticos</a></li>
|
|||
|
|
<li><a href="#backslash">Backslash Escapes</a></li>
|
|||
|
|
</ul></li>
|
|||
|
|
</ul>
|
|||
|
|
|
|||
|
|
<hr />
|
|||
|
|
|
|||
|
|
<h2 id="overview">Visi<EFBFBD>n general</h2>
|
|||
|
|
|
|||
|
|
<h3 id="philosophy">Filosof<EFBFBD>a</h3>
|
|||
|
|
|
|||
|
|
<P>Markdown pretende ser tan f<>cil de leer y f<>cil de escribir como sea
|
|||
|
|
posible.</P>
|
|||
|
|
<P>La facilidad de lectura, sin embargo, predomina sobre todo lo dem<65>s. Un
|
|||
|
|
documento con formato Markdown deber<65>a ser publicable como es, como texto plano,
|
|||
|
|
sin parecer que ha sido mejorado con etiquetas o intrucciones de formato. Aun
|
|||
|
|
cuando la sintaxis de Markdown ha sido influenciada por varios filtros
|
|||
|
|
conversores de texto a HTML existentes <20> incluyendo <A
|
|||
|
|
href="http://docutils.sourceforge.net/mirror/setext.html">Setext</A>, <A
|
|||
|
|
href="http://www.aaronsw.com/2002/atx/">atx</A>, <A
|
|||
|
|
href="http://textism.com/tools/textile/">Textile</A>, <A
|
|||
|
|
href="http://docutils.sourceforge.net/rst.html">reStructuredText</A>, <A
|
|||
|
|
href="http://www.triptico.com/software/grutatxt.html">Grutatext</A>, y <A
|
|||
|
|
href="http://ettext.taint.org/doc/">EtText</A> <20> la mayor fuente de inspiraci<63>n
|
|||
|
|
para la sintaxis de Markdown es el formato de texto plano de email.</P>
|
|||
|
|
<P>Para finalizar con esto, la sintaxis de Markdown est<73> compuesta completamente
|
|||
|
|
de signos de puntuaci<63>n, los cuales han sido cuidadosamente escogidos de forma
|
|||
|
|
que parezcan lo que significan. Por ejemplo, asteriscos alrededor de una palabra
|
|||
|
|
aparecen como *emphasis*. Las listas en Markdown parecen eso, listas.
|
|||
|
|
Incluso las citas tienen la apariencia de pasajes de texto citados, asumiendo que ha
|
|||
|
|
usado alguna vez el email.</P>
|
|||
|
|
<H3 id=html>HTML en l<>nea </H3>
|
|||
|
|
<P>La sintaxis de Markdown tiene una finalidad: ser usada como un formato para
|
|||
|
|
<EM>escribir</EM> para la web.</P>
|
|||
|
|
<P>Markdown no es un sustituto del HTML, ni siquiera est<73> cercano a <20>l. Su
|
|||
|
|
sintaxis es muy limitada, correspondiendo <20>nicamente a un muy peque<75>o
|
|||
|
|
subconjunto de etiquetas HTML. La idea <EM>no</EM> es crear una sintaxis que
|
|||
|
|
haga m<>s f<>cil insertar etiquetas HTML. En mi opini<6E>n, las etiquetas HTML ya son
|
|||
|
|
f<EFBFBD>ciles de insertar. La idea subyacente en Markdown es hacer el texto f<>cil de leer,
|
|||
|
|
escribir y editar. HTML es un formato de <EM>publicaci<EFBFBD>n</EM>; Markdown es un
|
|||
|
|
formato de<EM> escritura</EM>. Adem<65>s, la sintaxis de formato de Markdown
|
|||
|
|
<EFBFBD>nicamente tiene como destino cuestiones que pueden ser expresadas en texto
|
|||
|
|
plano.</P>
|
|||
|
|
<P>Para aquellas marcas que no est<73>n cubiertas por la sintaxis de Markdown,
|
|||
|
|
simplemente use el propio HTML. No hay ninguna necesidad de indicar que est<73>
|
|||
|
|
cambiando de Markdown a HTML; <20>nicamente use las etiquetas.</P>
|
|||
|
|
<P>Las <20>nicas limitaciones aparecen en los elementos a nivel de bloque de HTML <20>
|
|||
|
|
p. e. <CODE><div></CODE>, <CODE><table></CODE>,
|
|||
|
|
<CODE><pre></CODE>, <CODE><p></CODE>, etc. <20> deben estar separadas
|
|||
|
|
del contenido que las rodea por l<>neas vac<61>as, y las etiquetas de comienzo y
|
|||
|
|
final de bloque no deben tener tabuladores o espacios. Markdown es lo
|
|||
|
|
suficientemente listo como para no a<>adir etiquetas <CODE><p></CODE>
|
|||
|
|
adicionales (no queridas) alrededor de las etiquetas de bloque de HTML.</P>
|
|||
|
|
<P>Por ejemplo, para a<>adir una tabla HTML a un art<72>culo Markdown:</P><PRE><CODE>Este es un p<>rrafo normal.
|
|||
|
|
|
|||
|
|
<table>
|
|||
|
|
<tr>
|
|||
|
|
<td>Foo</td>
|
|||
|
|
</tr>
|
|||
|
|
</table>
|
|||
|
|
|
|||
|
|
Este es otro p<>rrafo normal.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Note que la sintaxis de formato Markdown no es procesada dentro de etiquetas
|
|||
|
|
HTML de bloque. P. e., no se puede usar el estilo <CODE>*emphasis*</CODE> dentro
|
|||
|
|
de un bloque HTML.</P>
|
|||
|
|
<P>Las etiquetas HTML de Span <20> p.e. <CODE><span></CODE>,
|
|||
|
|
<CODE><cite></CODE>, o <CODE><del></CODE> <20> pueden usarse en
|
|||
|
|
cualquier lugar en un p<>rrafo Markdown, lista de items, o encabezado. Si lo
|
|||
|
|
desea, puede incluso usar etiquetas HTML en lugar de formato Markdown; p.e. si
|
|||
|
|
prefiere usar las etiquetas HTML <CODE><a></CODE> o
|
|||
|
|
<CODE><img></CODE> en lugar de la sintaxis de enlaces o im<69>genes de
|
|||
|
|
Markdown, no hay problema en que lo haga.</P>
|
|||
|
|
<P>Al contrario de las etiquetas de bloque de HTML, la sintaxis de Markdown
|
|||
|
|
<EM>es</EM> procesada dentro de etiquetas de span.</P>
|
|||
|
|
<H3 id=autoescape>Escape Autom<6F>tico para Caracteres Especiales</H3>
|
|||
|
|
<P>En HTML, hay dos s<>mbolos que exigen un tratamiento especial:
|
|||
|
|
<CODE><</CODE> y <CODE>&</CODE>. El s<>mbolo de <20>ngulo izquierdo se
|
|||
|
|
utiliza para iniciar etiquetas; los ampersands se utilizan para indicar
|
|||
|
|
entidades en HTML. Si quiere utilizarlos como s<>mbolos literales, debe utilizar
|
|||
|
|
caracteres de escape para marcarlos, p.e. <CODE>&lt;</CODE>, y
|
|||
|
|
<CODE>&amp;</CODE>.</P>
|
|||
|
|
<P>Los ampersands en particular son una molestia para los escritores web. Si
|
|||
|
|
quiere escribir <20>AT&T<EFBFBD>, debe escribir <20><CODE>AT&amp;T</CODE><EFBFBD>. Incluso
|
|||
|
|
necesita escapar los ampersands dentro de URLs. As<41>, si quiere enlazar a:</P><PRE><CODE>http://images.google.com/images?num=30&q=larry+bird
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>necesita codificar la URL como:</P><PRE><CODE>http://images.google.com/images?num=30&amp;q=larry+bird
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>en el atributo de su etiqueta <CODE>href</CODE>. No hay que decir que esto es
|
|||
|
|
f<EFBFBD>cil de olvidar, y es probablemente la fuente m<>s habitual de errores de
|
|||
|
|
HTML.</P>
|
|||
|
|
<P>Markdown le permite utilizar estos s<>mbolos de forma natural, realizando por
|
|||
|
|
usted todos los escapes necesarios. Si usa un ampersand como parte de una
|
|||
|
|
entidad HTML, se mantiene inalterado; de otra forma ser<65>a traducido como
|
|||
|
|
<CODE>&amp;</CODE>.</P>
|
|||
|
|
<P>As<EFBFBD>, si quiere incluir un s<>mbolo de copyright en su art<72>culo, puede
|
|||
|
|
escribir:</P><PRE><CODE>&copy;
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>y Markdown lo dejar<61> tal cual. Pero si escribe:</P><PRE><CODE>AT&T
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Markdown lo traducir<69> a:</P><PRE><CODE>AT&amp;T
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>De forma similar, y puesto que Markdown soporta <A
|
|||
|
|
href="http://moodle.org/file.php/11/moddata/forum/101/78232/markdown.htm#html">HTML
|
|||
|
|
en l<>nea </A>, si utiliza s<>mbolos de <20>ngulo como delimitadores de etiquetas de
|
|||
|
|
HTML, Markdown los tratar<61> como tales. Pero si escribe:</P><PRE><CODE>4 < 5
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Markdown lo traducir<69> a:</P><PRE><CODE>4 &lt; 5
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Sin embargo, dentro del c<>digo Markdown, spans y bloques, s<>mbolos de <20>ngulo
|
|||
|
|
y ampersands son<EM> siempre</EM> codificados autom<6F>ticamente. <20>sto hace f<>cil
|
|||
|
|
usar Markdown para escribir sobre el c<>digo HTML. (De forma opuesta al tosco
|
|||
|
|
HTML, que es un formato terrible para escribir sobre la sintaxis HTML, ya que
|
|||
|
|
cada <CODE><</CODE> and <CODE>&</CODE> en su c<>digo de ejemplo necesita
|
|||
|
|
ser escapado.)</P>
|
|||
|
|
<HR>
|
|||
|
|
|
|||
|
|
<h3 id="p">P<EFBFBD>rrafos y Saltos de l<>nea</h3>
|
|||
|
|
|
|||
|
|
<p>Un p<>rrafo consiste simplemente en una o m<>s l<>neas consecutivas de texto separadas
|
|||
|
|
por una o m<>s l<>neas en blanco. (Una l<>nea en blanco es cualquier l<>nea que tiene esa apariencia — una
|
|||
|
|
l<EFBFBD>nea que contenga s<>lo espacios o tabulaciones se considera
|
|||
|
|
una l<>nea en blanco.) Los p<>rrafos normales no deber<65>an sangrarse con espacios o tabulaciones.</p>
|
|||
|
|
|
|||
|
|
<p>La regla “una o m<>s l<>neas consecutivas de texto” implica
|
|||
|
|
que Markdown admite p<>rrafos de texto “hard-wrapped”. Esto lo diferencia
|
|||
|
|
significativamente de la mayor<6F>a del resto de formateadores de texto a HTML (incluyendo la opci<63>n
|
|||
|
|
“Convertir Saltos de L<>nea” de Movable Type) que traducen cada car<61>cter de salto de l<>nea
|
|||
|
|
en un p<>rrafo encerrado en una marca <code><br /></code>.</p>
|
|||
|
|
|
|||
|
|
<p>Si usted desea <em>realmente</em> insertar una marca <code><br /></code> de salto de l<>nea usando Markdown,
|
|||
|
|
s<EFBFBD>lo tiene que finalizar una l<>nea con dos o m<>s espacios, y a continuaci<63>n pulsar la tecla de retorno.</p>
|
|||
|
|
|
|||
|
|
<p>Ciertamente, es m<>s trabajoso crear un <code><br /></code>, pero la regla simple
|
|||
|
|
“cada salto de l<>nea es un <code><br /></code>” no funciona en Markdown.
|
|||
|
|
El estilo email <a href="#blockquote">blockquoting</a> de Markdown y el multi-p<>rrafo <a href="#list">list items</a>
|
|||
|
|
funcionan mejor — y tienen mejor aparicneia — cuando usted los formatea con saltos de l<>nea duros.</p>
|
|||
|
|
|
|||
|
|
<h3 id="header">Cabeceras</h3>
|
|||
|
|
|
|||
|
|
<p>Markdown soporta dos estilos de cabeceras, <a href="http://docutils.sourceforge.net/mirror/setext.html">Setext</a> y <a href="http://www.aaronsw.com/2002/atx/">atx</a>.</p>
|
|||
|
|
|
|||
|
|
<p>Las cabeceras de estilo Setext est<73>n “subrayadas” y usan el signo igual "=" (para cabeceras de primer nivel) y guiones cortos "-" (para cabeceras de segundo nivel). Por ejemplo:</p>
|
|||
|
|
|
|||
|
|
<pre><code><EFBFBD>sta es una H1
|
|||
|
|
=============
|
|||
|
|
|
|||
|
|
<EFBFBD>sta es una H2
|
|||
|
|
-------------
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Funcionar<EFBFBD> cualquier n<>mero de signos <code>=</code>; o <code>-</code>;.</p>
|
|||
|
|
|
|||
|
|
<p>Las cabeceras de estilo Atx utilizan de 1 a 6 almohadillas al comienzo de cada l<>nea,
|
|||
|
|
que corresponden a los niveles de cabecera de 1 a 6. Por ejemplo:</p>
|
|||
|
|
|
|||
|
|
<pre><code># <20>sta es una H1
|
|||
|
|
|
|||
|
|
## <20>sta es una H2
|
|||
|
|
|
|||
|
|
###### <20>sta es una H6
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Si lo desea, usted puede “cerrar” cabeceras de estilo atx. Esto es meramente
|
|||
|
|
cosm<EFBFBD>tico — puede usar esta opci<63>n si le parece que queda mejor. El n<>mero de
|
|||
|
|
almohadillas de cierre no necesita coincidir con el n<>mero de almohadillas
|
|||
|
|
usado para abrir la cabecera. (El n<>mero de almohadillas de apertura determina el nivel de la cabecera.) :</p>
|
|||
|
|
|
|||
|
|
<pre><code># <20>sta es una H1 #
|
|||
|
|
|
|||
|
|
## <20>sta es una H2 ##
|
|||
|
|
|
|||
|
|
### <20>sta es una H3 ######
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<h3 id="blockquote">Citas</h3>
|
|||
|
|
|
|||
|
|
<p>Markdown utiliza caracteres <code>></code> tipo email para las citas. Si usted est<73>
|
|||
|
|
familiarizado con la cita de pasajes de texto en mensajes email, entonces seguramente
|
|||
|
|
sabr<EFBFBD> c<>mo crear una cita en Markdown. Tiene mejor apariencia si usted utiliza saltos de l<>nea
|
|||
|
|
duros y coloca un <code>></code> antes de cada l<>nea:</p>
|
|||
|
|
|
|||
|
|
<pre><code>> <20>sta es una cita con dos p<>rrafos. Lorem ipsum dolor sit amet,
|
|||
|
|
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
|
|||
|
|
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
|
|||
|
|
>
|
|||
|
|
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
|
|||
|
|
> id sem consectetuer libero luctus adipiscing.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Markdown le permite ser perezoso, de modo que <20>nicamente ha de poner el <code>></code> antes de la primera
|
|||
|
|
l<EFBFBD>nea de un p<>rrafo con saltos de l<>nea duros:</p>
|
|||
|
|
|
|||
|
|
<pre><code>> <20>sta es una cita con dos p<>rrafos. Lorem ipsum dolor sit amet,
|
|||
|
|
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
|
|||
|
|
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
|
|||
|
|
|
|||
|
|
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
|
|||
|
|
id sem consectetuer libero luctus adipiscing.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Las citas pueden estar anidadas (i.e. una cita dentro de otra)
|
|||
|
|
a<EFBFBD>adiendo niveles adicionales de <code>></code>:</p>
|
|||
|
|
|
|||
|
|
<pre><code>> <20>ste es el primer nivel de cita.
|
|||
|
|
>
|
|||
|
|
> > <20>sta es la cita anidada.
|
|||
|
|
>
|
|||
|
|
> Regreso al primer nivel.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Las citas pueden tener otros elementos Markdown elements, incluyendo cabeceras, listas,
|
|||
|
|
y bloques de c<>digo:</p>
|
|||
|
|
|
|||
|
|
<pre><code>> ## <20>sta es una cabecera.
|
|||
|
|
>
|
|||
|
|
> 1. <20>ste es el primer <20>tem de la lista.
|
|||
|
|
> 2. <20>ste es el segundo <20>tem de la lista.
|
|||
|
|
>
|
|||
|
|
> He aqu<71> algunos ejemplos de c<>digo:
|
|||
|
|
>
|
|||
|
|
> return shell_exec("echo $input | $markdown_script");
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Cualquier editor decente de texto debr<62>a facilitar la construcci<63>n de citas tipo email. Por
|
|||
|
|
ejemplo, con BBEdit, usted puede hacer una selecci<63>n y elegir Increase
|
|||
|
|
Quote Level en el men<65> Text.</p>
|
|||
|
|
|
|||
|
|
<h3 id="list">Listas</h3>
|
|||
|
|
|
|||
|
|
<p>Markdown soporta listas ordenadas (numeradas) y sin ordenar (con vi<76>etas).</p>
|
|||
|
|
|
|||
|
|
<p>Las listas no ordenadas utilizan asteriscos, signos + y guiones — de modo intercambiable
|
|||
|
|
— como marcadores de lista:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Rojo
|
|||
|
|
* Verde
|
|||
|
|
* Azul
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>es equivalente a:</p>
|
|||
|
|
|
|||
|
|
<pre><code>+ Rojo
|
|||
|
|
+ Verde
|
|||
|
|
+ Azul
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>y a:</p>
|
|||
|
|
|
|||
|
|
<pre><code>- Rojo
|
|||
|
|
- Verde
|
|||
|
|
- Azul
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Las listas ordenadas usan n<>meros seguidos de puntos:</p>
|
|||
|
|
|
|||
|
|
<pre><code>1. Bird
|
|||
|
|
2. McHale
|
|||
|
|
3. Parish
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Es importante advertir que los n<>meros reales que usted utiliza para marcar la
|
|||
|
|
lista no tienen efecto en la salida HTML producida por Markdown. La salida HTML de
|
|||
|
|
Markdown resultado de la lista anterior es:</p>
|
|||
|
|
|
|||
|
|
<pre><code><ol>
|
|||
|
|
<li>Bird</li>
|
|||
|
|
<li>McHale</li>
|
|||
|
|
<li>Parish</li>
|
|||
|
|
</ol>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Si, en cambio, usted escribi<62> la lista en Markdown as<61>:</p>
|
|||
|
|
|
|||
|
|
<pre><code>1. Bird
|
|||
|
|
1. McHale
|
|||
|
|
1. Parish
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>o incluso:</p>
|
|||
|
|
|
|||
|
|
<pre><code>3. Bird
|
|||
|
|
1. McHale
|
|||
|
|
8. Parish
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>usted conseguir<69>a exactamente la misma salida HTML. El asunto es, si as<61> lo desea,
|
|||
|
|
usar n<>meros ordinales en sus listas ordenadas Markdown, de modo que
|
|||
|
|
los n<>meros del c<>digo fuente coincidan con los n<>meros del HTML publicado.
|
|||
|
|
Pero si opta por la pereza, ni siquiera tiene que hacerlo.</p>
|
|||
|
|
|
|||
|
|
<p>Sin embargo, si quiere usar la numeraci<63>n perezosa, a<>n deber<65>a comenzar la
|
|||
|
|
lista con el n<>mero 1. En el futuro, Markdown admitir<69>
|
|||
|
|
comenzar listas ordenadas con cualquier n<>mero arbitrario.</p>
|
|||
|
|
|
|||
|
|
<p>Los marcadores de lista normalmente comienzan en el margen izquierdo, pero pueden ser sangradas con un m<>ximo de
|
|||
|
|
tres espacios. Los marcadores de lista deben ir seguidos de uno o m<>s espacios,
|
|||
|
|
o de una tabulaci<63>n.</p>
|
|||
|
|
|
|||
|
|
<p>Para conseguir que las listas queden bien, puede desplazar los <20>tems con sangrados colgantes:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
|
|||
|
|
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
|
|||
|
|
viverra nec, fringilla in, laoreet vitae, risus.
|
|||
|
|
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
|
|||
|
|
Suspendisse id sem consectetuer libero luctus adipiscing.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Pero, si opta por la pereza, ni siquiera tiene que hacerlo:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
|
|||
|
|
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
|
|||
|
|
viverra nec, fringilla in, laoreet vitae, risus.
|
|||
|
|
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
|
|||
|
|
Suspendisse id sem consectetuer libero luctus adipiscing.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Si los <20>tems de la lista est<73>n separados por l<>neas en blanco, Markdown desplazar<61> los
|
|||
|
|
<EFBFBD>tems en marcas <code><p></code> en la salida HTML. Por ejemplo, esta entrada:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Bird
|
|||
|
|
* Magic
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>se convertir<69> en:</p>
|
|||
|
|
|
|||
|
|
<pre><code><ul>
|
|||
|
|
<li>Bird</li>
|
|||
|
|
<li>Magic</li>
|
|||
|
|
</ul>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Pero <20>sta:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Bird
|
|||
|
|
|
|||
|
|
* Magic
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>se convertir<69> en:</p>
|
|||
|
|
|
|||
|
|
<pre><code><ul>
|
|||
|
|
<li><p>Bird</p></li>
|
|||
|
|
<li><p>Magic</p></li>
|
|||
|
|
</ul>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Los <20>tems de la lista pueden consistir en m<>ltiples p<>rrafos. Cada p<>rrafo
|
|||
|
|
subsiguiente deber<65> sangrarse bien con 4 espacios, bien con una tabulaci<63>n:</p>
|
|||
|
|
|
|||
|
|
<pre><code>1. <20>ste es un <20>tem con dos p<>rrafos. Lorem ipsum dolor
|
|||
|
|
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
|
|||
|
|
mi posuere lectus.
|
|||
|
|
|
|||
|
|
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
|
|||
|
|
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
|
|||
|
|
sit amet velit.
|
|||
|
|
|
|||
|
|
2. Suspendisse id sem consectetuer libero luctus adipiscing.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Sangrar cada l<>nea de los p<>rrafos subsiguientes tiene una mejor apariencia
|
|||
|
|
pero, una vez m<>s, Markdown le permite ser
|
|||
|
|
perezoso:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* <20>ste es un <20>tem con dos p<>rrafos.
|
|||
|
|
|
|||
|
|
<20>ste es el segundo p<>rrafo del <20>tem de la lista. <20>nicamente
|
|||
|
|
se exige sangrar la primera l<>nea. Lorem ipsum dolor
|
|||
|
|
sit amet, consectetuer adipiscing elit.
|
|||
|
|
|
|||
|
|
* Otro <20>tem de la misma lista.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Para colocar una cita dentro de un <20>tem de una lista, es preciso que los delimitadores <code>></code> de la cita
|
|||
|
|
est<EFBFBD>n sangrados:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Un <20>tem de lista con una cita:
|
|||
|
|
|
|||
|
|
> <20>sta es una cita
|
|||
|
|
> dentro de un <20>tem de una lista.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Para colocar un bloque de c<>digo dentro de un <20>tem de una lista, es preciso que el bloque de c<>digo
|
|||
|
|
est<EFBFBD> sangrado <em>dos veces</em> — con 8 espacios o dos tabulaciones:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* Un <20>tem de una lista con un bloque de c<>digo:
|
|||
|
|
|
|||
|
|
<el c<>digo va aqu<71>>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Merece la pena poner de manifiesto que es posible disparar una lista ordenada por
|
|||
|
|
accidente, escribiendo algo como esto:</p>
|
|||
|
|
|
|||
|
|
<pre><code>1986. What a great season.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>En otras palabras, una secuencia <em>n<EFBFBD>mero-punto-espacio</em> al comienzo de una
|
|||
|
|
l<EFBFBD>nea. Para evitar esto, usted puede colocar una barra invertida (\) antes del punto:</p>
|
|||
|
|
|
|||
|
|
<pre><code>1986\. What a great season.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<h3 id="precode">Bloques de c<>digo</h3>
|
|||
|
|
|
|||
|
|
<p>Los bloques de c<>digo pre-formateados se utilizan para escribir en programaci<63>n o
|
|||
|
|
en el c<>digo fuente de marcas. En lugar de formar p<>rrafos normales, las l<>neas
|
|||
|
|
de un bloque de c<>digo se interpretan literalmente. Markdown desplaza un bloque de c<>digo
|
|||
|
|
en marcas tanto <code><pre></code> como <code><code></code>.</p>
|
|||
|
|
|
|||
|
|
<p>Para producir un bloque de c<>digo en Markdown, simplemente sangre cada l<>nea del
|
|||
|
|
bloque con al menos 4 espacios o un tabulador. Por ejemplo, dada esta entrada:</p>
|
|||
|
|
|
|||
|
|
<pre><code><EFBFBD>ste es un p<>rrafo normal:
|
|||
|
|
|
|||
|
|
<20>ste es un bloque de c<>digo.
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Markdown generar<61>:</p>
|
|||
|
|
|
|||
|
|
<pre><code><p><EFBFBD>ste es un p<>rrafo normal:</p>
|
|||
|
|
|
|||
|
|
<pre><code><EFBFBD>ste es un bloque de c<>digo.
|
|||
|
|
</code></pre>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Un nivel de sangrado — 4 espacios o 1 tabulador — es removido de cada
|
|||
|
|
l<EFBFBD>nea del bloque de c<>digo. Por ejemplo, <20>ste:</p>
|
|||
|
|
|
|||
|
|
<pre><code>He aqu<71> un ejemplo de AppleScript:
|
|||
|
|
|
|||
|
|
tell application "Foo"
|
|||
|
|
beep
|
|||
|
|
end tell
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>se convertir<69> en:</p>
|
|||
|
|
|
|||
|
|
<pre><code><p>He aqu<71> un ejemplo de AppleScript:</p>
|
|||
|
|
|
|||
|
|
<pre><code>tell application "Foo"
|
|||
|
|
beep
|
|||
|
|
end tell
|
|||
|
|
</code></pre>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>Un bloque de c<>digo contin<69>a hasta que alcanza una l<>nea que no est<73> sangrada
|
|||
|
|
(o bien el final del art<72>culo).</p>
|
|||
|
|
|
|||
|
|
<p>Dentro de un bloque de c<>digo, los ampersands (<code>&</code>) y los corchetes angulares (<code><</code> y <code>></code>)
|
|||
|
|
son convertidos autom<6F>ticamente en entidades HTML. Esto hace muy
|
|||
|
|
f<EFBFBD>cil incluir c<>digo fuente HTML de ejemplo usando Markdown — simplemente tiene que pegarlo e
|
|||
|
|
sangrarlo, y Markdown manejar<61> el engorro que supone codificar las arrobas y los corchetes angulares. Por ejemplo, esto:</p>
|
|||
|
|
|
|||
|
|
<pre><code> <div class="footer">
|
|||
|
|
&copy; 2004 Foo Corporation
|
|||
|
|
</div>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>se convierte en:</p>
|
|||
|
|
|
|||
|
|
<pre><code><pre><code>&lt;div class="footer"&gt;
|
|||
|
|
&amp;copy; 2004 Foo Corporation
|
|||
|
|
&lt;/div&gt;
|
|||
|
|
</code></pre>
|
|||
|
|
</code></pre>
|
|||
|
|
|
|||
|
|
<p>La sintaxis regular Markdown no es procesada dentro de los c<>digos de bloque. E.g.,
|
|||
|
|
los asteriscos son literalmente asteriscos dentro de un c<>digo de bloque. Esto significa
|
|||
|
|
que tambi<62>n result<6C> f<>cil usar Markdown para escribir sobre la propia sintaxis de Markdown.</p>
|
|||
|
|
|
|||
|
|
<h3 id="hr">Reglas horizontales</h3>
|
|||
|
|
|
|||
|
|
<p>Usted puede producir una marca de regla horizontal (<code><hr /></code>) escribiendo tres o
|
|||
|
|
m<EFBFBD>s guiones o asteriscos en una l<>nea. Si lo desea, puede
|
|||
|
|
usar espacios entre los guiones o asteriscos. Cada una de las l<>neas
|
|||
|
|
siguientes dar<61> como resultado una l<>nea horizontal:</p>
|
|||
|
|
|
|||
|
|
<pre><code>* * *
|
|||
|
|
|
|||
|
|
***
|
|||
|
|
|
|||
|
|
*****
|
|||
|
|
|
|||
|
|
- - -
|
|||
|
|
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<HR>
|
|||
|
|
|
|||
|
|
<H2 id=span>Span Elements</H2>
|
|||
|
|
<H3 id=link>Enlaces</H3>
|
|||
|
|
<P>Markdown permite dos estilos de enlaces: <I>en l<>nea</I> y
|
|||
|
|
<I>referencias</I>.</P>
|
|||
|
|
<P>En ambos estilos, el texto del enlace est<73> delimitado por [corchetes].</P>
|
|||
|
|
<P>Para crear un enlace en l<>nea, utilice un par de par<61>ntesis normales
|
|||
|
|
inmediatamente despu<70>s del corchete de cierre del texto del enlace. Dentro de
|
|||
|
|
par<EFBFBD>ntesis, ponga la URL, junto con un t<>tulo del enlace opcional entre
|
|||
|
|
comillas. Por ejemplo:</P><PRE><CODE>This is [an example](http://example.com/ "Title") inline link.
|
|||
|
|
|
|||
|
|
[This link](http://example.net/) has no title attribute.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Producir<EFBFBD>:</P><PRE><CODE><p>This is <a href="http://example.com/" title="Title">
|
|||
|
|
an example</a> inline link.</p>
|
|||
|
|
|
|||
|
|
<p><a href="http://example.net/">This link</a> has no
|
|||
|
|
title attribute.</p>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Si estamos haciendo referencia a un recurso local en el mismo servidor,
|
|||
|
|
podemos utilizar las referencias relativas:</P><PRE><CODE>See my [About](/about/) page for details.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Los enlaces de Referencia-estilo utilizan un segundo conjunto de corchetes,
|
|||
|
|
dentro de los cuales podemos poner una etiqueta de nuestra elecci<63>n para
|
|||
|
|
identificar el enlace:</P><PRE><CODE>This is [an example][id] reference-style link.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Opcionalmente podemos utilizar un espacio para separar los
|
|||
|
|
corchetes:</P><PRE><CODE>This is [an example] [id] reference-style link.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Despu<EFBFBD>s, en cualquier parte del documento, podemos definir nuestra etiqueta
|
|||
|
|
del enlace, en la propia l<>nea:</P><PRE><CODE>[id]: http://example.com/ "Optional Title Here"
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Eso es:</P>
|
|||
|
|
<UL>
|
|||
|
|
<LI>corchetes que contienen el identificador del enlace (opcionalmente
|
|||
|
|
sangrado en el margen izquierdo usando espacios o tabuladores);
|
|||
|
|
<LI>seguido por dos puntos;
|
|||
|
|
<LI>seguido por unos o m<>s espacios (o tabuladores); ;
|
|||
|
|
<LI>seguido por el URL del enlace;
|
|||
|
|
<LI>seguido opcionalmente por el atributo t<>tulo del enlace, entre en
|
|||
|
|
comillas. </LI></UL>
|
|||
|
|
<P>El URL del enlace se puede, rodear opcionalmente por <>:</P><PRE><CODE>[id]: <http://example.com/> "Optional Title Here"
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Podemos poner el atributo t<>tulo en la l<>nea siguiente y utilizar espacios
|
|||
|
|
adicionales o tabuladores sangrar, para ver mejor los URLs m<>s largo:</P><PRE><CODE>[id]: http://example.com/longish/path/to/resource/here
|
|||
|
|
"Optional Title Here"
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Las definiciones de los enlaces se utilizan solamente para crear los enlaces
|
|||
|
|
durante el proceso Markdown, y se eliminan del documento en la salida HTML.</P>
|
|||
|
|
<P>Los nombres de la definici<63>n de los enlaces pueden ser letras, de n<>meros,
|
|||
|
|
espacios, y signos de puntuaci<63>n -- pero ellos no son distinguen entre
|
|||
|
|
may<EFBFBD>sculas y min<69>sculas. Ejemplo, estos dos acoplamientos:</P><PRE><CODE>[link text][a]
|
|||
|
|
[link text][A]
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>son equivalentes.</P>
|
|||
|
|
<P>La atajo del <I>nombre del enlace impl<70>cito</I> nos permite omitir el nombre
|
|||
|
|
del enlace, en estos caso el propio texto del enlace se utiliza como el nombre.
|
|||
|
|
Usaremos solamente un par de corchetes vac<61>os -- ejemplo., para enlazar la
|
|||
|
|
palabra "Google" al sitio Web de google.com, podemos escribir simplemente:</P><PRE><CODE>[Google][]
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Y despu<70>s definir el enlace:</P><PRE><CODE>[Google]: http://google.com/
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Porque los nombres de los enlaces pueden contener espacios, los atajos
|
|||
|
|
funcionan incluso en las palabras m<>ltiples del texto del enlace:</P><PRE><CODE>Visit [Daring Fireball][] for more information.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Y despu<70>s definir el enlace::</P><PRE><CODE>[Daring Fireball]: http://daringfireball.net/
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Las definiciones de los enlaces se pueden poner en cualquier parte del
|
|||
|
|
documento Markdown. Tiendo para ponerlas inmediatamente despu<70>s de cada p<>rrafo
|
|||
|
|
en el cual se utilizan, pero si usted desea, usted puede ponerlas todas en el
|
|||
|
|
final de su documento, a manera de notas al pie de la p<>gina.</P>
|
|||
|
|
<P>Aqu<EFBFBD> tenemos un ejemplo de los enlaces a modo de referencias:</P><PRE><CODE>I get 10 times more traffic from [Google] [1] than from
|
|||
|
|
[Yahoo] [2] or [MSN] [3].
|
|||
|
|
|
|||
|
|
[1]: http://google.com/ "Google"
|
|||
|
|
[2]: http://search.yahoo.com/ "Yahoo Search"
|
|||
|
|
[3]: http://search.msn.com/ "MSN Search"
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Usando el atajo impl<70>cito del nombre de los enlaces, podr<64>amos escribirlo de
|
|||
|
|
la siguiente manera:</P><PRE><CODE>I get 10 times more traffic from [Google][] than from
|
|||
|
|
[Yahoo][] or [MSN][].
|
|||
|
|
|
|||
|
|
[google]: http://google.com/ "Google"
|
|||
|
|
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
|
|||
|
|
[msn]: http://search.msn.com/ "MSN Search"
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Ambos ejemplos anteriores producir<69>n el siguiente HTML de salida:</P><PRE><CODE><p>I get 10 times more traffic from <a href="http://google.com/"
|
|||
|
|
title="Google">Google</a> than from
|
|||
|
|
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
|
|||
|
|
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Para comparar, aqu<71> est<73> el mismo p<>rrafo escrito usando el estilo en l<>nea
|
|||
|
|
de enlaces de Markdown:</P><PRE><CODE>I get 10 times more traffic from [Google](http://google.com/ "Google")
|
|||
|
|
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
|
|||
|
|
[MSN](http://search.msn.com/ "MSN Search").
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Los enlaces del referencia-estilo no son m<>s f<>ciles de escribir. El clave es
|
|||
|
|
que con enlaces de referencia-estilo el documento fuente es sumamente m<>s
|
|||
|
|
legible. Compare los ejemplos anteriores: usando enlaces de referencia-estilo,
|
|||
|
|
el p<>rrafo tiene solamente 81 caracteres de largo; con enlaces del en
|
|||
|
|
l<EFBFBD>nea-estilo, es 176 caracteres; y como HTML, es 234 caracteres. En el HTML, hay
|
|||
|
|
m<EFBFBD>s etiquetas que texto.</P>
|
|||
|
|
<P>Con los enlaces del referencia-estilo de Mardown, un documento fuente se
|
|||
|
|
asemeja mucho m<>s a como lo mostrar<61> su navegador el documento final.
|
|||
|
|
Permitiendo que usted mueva las etiquetas relativas a los meta datos fuera del
|
|||
|
|
p<EFBFBD>rrafo, usted podr<64> agregar enlaces sin la interrupci<63>n del flujo narrativo de
|
|||
|
|
su prosa.</P>
|
|||
|
|
<H3 id=em><EFBFBD>nfasis</H3>
|
|||
|
|
<P>Markdown utiliza el asterisco (*) y los guiones bajos (_) como indicadores del
|
|||
|
|
<EFBFBD>nfasis. Un texto envuelto con uno * o _ ser<65> convertido en la etiqueta del HTML
|
|||
|
|
< em >; doble * o '_ ' s ser<65> envuelto con un HTML etiqueta <
|
|||
|
|
strong >. Por ejemplo, estas l<>neas:</P><PRE><CODE>*single asterisks*
|
|||
|
|
|
|||
|
|
_single underscores_
|
|||
|
|
|
|||
|
|
**double asterisks**
|
|||
|
|
|
|||
|
|
__double underscores__
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>producir<EFBFBD>n:</P><PRE><CODE><em>single asterisks</em>
|
|||
|
|
|
|||
|
|
<em>single underscores</em>
|
|||
|
|
|
|||
|
|
<strong>double asterisks</strong>
|
|||
|
|
|
|||
|
|
<strong>double underscores</strong>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Podemos utilizar cualquier estilo donde queramos; la <20>nica restricci<63>n es que
|
|||
|
|
el mismo car<61>cter se debe utilizar para abrir y para cerrar el <20>nfasis. </P>
|
|||
|
|
<P>El <20>nfasis se puede utilizar en el centro de una palabra:</P><PRE><CODE>un*fucking*believable
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Pero si usted rodea * o _ con los espacios, ser<65> tratado como un asterisco o
|
|||
|
|
raya literal.</P>
|
|||
|
|
<P>Producir un asterisco o una raya literal en una posici<63>n para ser utilizada
|
|||
|
|
delimitador debe utilizar \ :</P><PRE><CODE>\*this text is surrounded by literal asterisks\*
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<H3 id=code>C<EFBFBD>digo</H3>
|
|||
|
|
<P>Para indicar c<>digo, envu<76>lvalo con (`). Mostrar<61> un bloque preformateado del
|
|||
|
|
c<EFBFBD>digo, esta etiqueta indica c<>digo dentro de un p<>rrafo normal. Por
|
|||
|
|
ejemplo:</P><PRE><CODE>Use the `printf()` function.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>producida:</P><PRE><CODE><p>Use the <code>printf()</code> function.</p>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Para incluir un car<61>cter literal de ` dentro de etiqueta de c<>digo, debemos
|
|||
|
|
poner \ seguido de ` en <20>l::</P><PRE><CODE>`There is a literal backtick (\`) here.`
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>O, si usted lo prefiere, puede utilizar m<>ltiples ` como la abertura y los
|
|||
|
|
delimitadores de cierre::</P><PRE><CODE>``There is a literal backtick (`) here.``
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Ambos ejemplos anteriores producir<69>n esto:</P><PRE><CODE><p><code>There is a literal backtick (`) here.</code></p>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Con una etiqueta de c<>digo, los signos "&" y los "<" y ">" se
|
|||
|
|
codifican como entidades del HTML autom<6F>ticamente, que hace f<>cil incluir
|
|||
|
|
etiquetas ejemplo de HTML. Markdown lo convierte en:</P><PRE><CODE>Please don't use any `<blink>` tags.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>en:</P><PRE><CODE><p>Please don't use any <code>&lt;blink&gt;</code> tags.</p>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Podemos teclear esto</P><PRE><CODE>`&#8212;` is the decimal-encoded equivalent of `&mdash;`.
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>para producir:</P><PRE><CODE><p><code>&amp;#8212;</code> is the decimal-encoded
|
|||
|
|
equivalent of <code>&amp;mdash;</code>.</p>
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<H3 id=img>Im<EFBFBD>genes</H3>
|
|||
|
|
<P>Obviamente, es bastante dif<69>cil idear una sintaxis "natural" para poner
|
|||
|
|
im<EFBFBD>genes en un formato de documento de texto.</P>
|
|||
|
|
<P>Markdown utiliza una sintaxis de imagen que se asemeja a la sintaxis
|
|||
|
|
de los enlaces, permitiendo dos estilos: <I>en l<>nea</I> y
|
|||
|
|
<I>referencia</I></P>
|
|||
|
|
<P>La sintaxis de imagen en l<>nea se muestra as<61>:</P><PRE><CODE>
|
|||
|
|
|
|||
|
|
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Esto es:</P>
|
|||
|
|
<UL>
|
|||
|
|
<LI>una etiqueta de exclamaci<63>n: <CODE>!</CODE>;
|
|||
|
|
<LI>seguida por un par de corchetes, que contienen el texto de la atributo alt
|
|||
|
|
de la imagen;
|
|||
|
|
<LI>seguido por un par de par<61>ntesis, que contienen la URL o la trayectoria a la
|
|||
|
|
imagen, y un atributo opcional de t<>tulo (title) entre ap<61>strofes </LI></UL>
|
|||
|
|
<P>La sintaxis de la imagen de estilo Referencia tiene esta apariencia:</P><PRE><CODE>![Alt text][id]
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>Donde <CODE>"id" </CODE>es el nombre la "identificaci<63>n" de una referencia
|
|||
|
|
definida de la imagen. Se definen las referencias de la imagen usando la
|
|||
|
|
sintaxis id<69>ntica a las referencias de los enlaces:</P><PRE><CODE>[id]: url/to/image "Optional title attribute"
|
|||
|
|
</CODE></PRE>
|
|||
|
|
<P>De momento, Markdown carece de sintaxis para especificar las
|
|||
|
|
dimensiones de una imagen; si esto es importante para usted, puede utilizar las
|
|||
|
|
etiquetas normales < img > de HTML.</P>
|
|||
|
|
<HR>
|
|||
|
|
|
|||
|
|
<h2 id="misc">Miscel<EFBFBD>nea</h2>
|
|||
|
|
<h3 id="autolink">Enlaces Autom<6F>ticos</h3>
|
|||
|
|
<p>Markdown permite un estilo de atajo para crear los enlaces "autom<6F>ticos" de
|
|||
|
|
URLs y de las direcciones de email: simplemente rodee el URL o la direcci<63>n
|
|||
|
|
email con los signos <>. Ello significa que mostrar<61> el texto real de la URL o de
|
|||
|
|
una direcci<63>n email, y tambi<62>n hace que sea un enlace clickable, usted puede
|
|||
|
|
hacer esto:</p><pre><code><http://example.com/>
|
|||
|
|
</code></pre>
|
|||
|
|
<p>Markdown lo convierte en:</p><pre><code><a href="http://example.com/">http://example.com/</a>
|
|||
|
|
</code></pre>
|
|||
|
|
<p>Los los vinculos autom<6F>ticos de las direcciones de email funcionan de forma
|
|||
|
|
semejante, excepto que Markdown tambi<62>n realice una conversi<73>n hexadecimal al
|
|||
|
|
azar que codifica para ayudar a ocultar su direcci<63>n a los programas que
|
|||
|
|
recolectan direcciones de emal para hacer spam. Por ejemplo, Markdown convertir<69>
|
|||
|
|
esto:</p><pre><code><address@example.com>
|
|||
|
|
</code></pre>
|
|||
|
|
<p>en algo que se parece a esto:</p><pre><code><a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
|
|||
|
|
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
|
|||
|
|
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
|
|||
|
|
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>
|
|||
|
|
</code></pre>
|
|||
|
|
<p>Se mostrar<61> en el navegador como
|
|||
|
|
<EFBFBD>address@example.com<6F>.</p>
|
|||
|
|
<p>(Esta clase de truco de codificaci<63>n dificultar<61> a muchos programas de spam
|
|||
|
|
aunque no enga<67>ar<61> definitivamente todos. Es mejor que nada, pero una direcci<63>n
|
|||
|
|
publicada sin codificar comenzar<61> probablemente a recibir el Spam.)</p>
|
|||
|
|
<h3 id="backslash">Backslash Escapes</h3>
|
|||
|
|
<p>Markdown nos permite utilizar escapes del backslash para generar los
|
|||
|
|
caracteres literales que tendr<64>an de otra manera significado especial en la
|
|||
|
|
sintaxis del formato de Markdown. Por ejemplo, si usted dese<73> rodear una palabra
|
|||
|
|
con los asteriscos literales (en vez de una etiqueta del HTML < em >), usted
|
|||
|
|
puede usar los backslashes antes de los asteriscos, como sigue: </p><pre><code>\*literal asterisks\*
|
|||
|
|
</code></pre>
|
|||
|
|
<p>Markdown proporciona los escapes del backslash para los siguientes caracteres
|
|||
|
|
:</p><pre><code>\ backslash (barra invertida)
|
|||
|
|
` backtick (acento grave)
|
|||
|
|
* asterisk (asterisco)
|
|||
|
|
_ underscore (subrayado)
|
|||
|
|
{} curly braces (llaves)
|
|||
|
|
[] square brackets (corchetes)
|
|||
|
|
() parentheses (par<61>ntesis)
|
|||
|
|
# hash mark (almohadilla)
|
|||
|
|
. dot (punto)
|
|||
|
|
! exclamation mark (exclamaci<63>n)
|
|||
|
|
</code></pre></div>
|
|||
|
|
<!-- article -->
|
|||
|
|
</div></body></html>
|