Markdown es una forma sencilla de escribir texto estructurado que puede convertirse directamente al 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:

En Markdown bastaría con escribir el siguiente texto:

|  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     |

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

<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>

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 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.

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 código JSP incrustado, ya sea dentro o fuera del bloque de etiquetas <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 editor auxiliar 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.