===== Markdown =====

{{wpes>Markdown}} es una forma sencilla de escribir texto estructurado que puede convertirse directamente al {{wpes>HTML|lenguaje HTML}}, que es el que usan las páginas web. A diferencia de HTML, Markdown es simple y no usa etiquetas de marcado, si no simples caracteres que indican el formato, de manera que resulta mas fácil y rápido escribir un texto. Por ejemplo, para crear la tabla:

|Alineado izquierda  |   Centrado                     |  Alienado derecha|
|Fila 1              |    **Negrita**                 |         Columna 3|
|Fila 2              |    //Italica//                 |         Columna 3|
|Fila 3              |   <del>Tachado</del>           |         Columna 3|
|Fila 4              |   [[https://www.siette.org|siette.org]]  |         Columna 3|

En Markdown bastaría con escribir el siguiente texto:

<code>
|  Alineado izquierda  |   Centrado         | Alienado derecha|
|:-------------------- |:------------------:| ---------------:|
| Fila 1               | **Negrita**        |   Columna 3     |
| Fila 2               | *Italica*          |   Columna 3     |
| Fila 3               | ~~Tachado~~        |   Columna 3     |
| Fila 3               | [Link](siette.org) |   Columna 3     |
</code>

y para escribir lo mismo en HTML habría que escribir el siguiente código:

<code>
<table>
<thead>
<tr class="header">
<th style="text-align: left;">Alineado izquierda</th>
<th style="text-align: center;">Centrado</th>
<th style="text-align: right;">Alienado derecha</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td style="text-align: left;">Fila 1</td>
<td style="text-align: center;"><strong>Negrita</strong></td>
<td style="text-align: right;">Columna 3</td>
</tr>
<tr class="even">
<td style="text-align: left;">Fila 2</td>
<td style="text-align: center;"><em>Italica</em></td>
<td style="text-align: right;">Columna 3</td>
</tr>
<tr class="odd">
<td style="text-align: left;">Fila 3</td>
<td style="text-align: center;"><del>Tachado</del></td>
<td style="text-align: right;">Columna 3</td>
</tr>
<tr class="even">
<td style="text-align: left;">Fila 3</td>
<td style="text-align: center;"><a href="siette.org">Link</a></td>
<td style="text-align: right;">Columna 3</td>
</tr>
</tbody>
</table>
</code>

Evidentemente es mucho mas fácil e intuitivo usar Markdown, teniendo en cuenta que a partir del texto en Markdown puede generarse automáticamente el código HTML usando alguna herramienta de conversión como [[wpes>pandoc]].

Todos los textos en Siette, para el enunciado, las respuestas, las ayudas y los refuerzos se espera que estén escritos íntegramente en HTML, pero pueden incluir un nuevo par de etiquetas: ''<MARKDOWN>'' y ''</MARKDONW>'' entre las cuales se sitúe un texto escrito en el formato de Markdown. Siette convertirá ese texto a HTML y lo incrustará sustituyendo este trozo de código.

==== Preguntas generativas ====

Las etiquetas **<MARKDOWN>**, al igual que otras etiquetas de Siette, pueden usarse también si se trata de una pregunta generativa, ya que la paginas es procesa previamente si usa  [[es:manual:items:generativos:jsp|código JSP]] incrustado, ya sea dentro o fuera del bloque de etiquetas **<MARKDOWN>**.

==== Alternativas a la etiqueta <MARKDOWN> ====
Es evidente que editar directamente el código HTML es tedioso, por lo que la opción mas sencilla es usar un editor de HTML. Siette incluye un botón para invocar al [[es:help_items_content#editor auxiliar]] [[https://www.tiny.cloud/|TinyMCE]] en los campos en donde se usa texto en HTML.

No obstante, si las preguntas provienen de un texto previamente escrito en Markdown, el uso de las etiquetas **<MARKDOWN>** evitará tener que volver a teclear el código y bastará con una operación de copiar y pegar.