Markdown para generar Documentación

¿No crees que es un poco cutre hacer la documentación de un proyecto en Word?

Hay varias opciones y voy a empezar a recopilar aquí sobre Markdown, que es la que más me ha llamado la atención.

Markdown

Markdown es un lenguaje de marcado ligero que trata de conseguir la máxima legibilidad y «publicabilidad» tanto en sus forma de entrada como de salida.

El hecho de que sea un marcado ligero está claro, utiliza mucho menos texto para sus marcas, consiguiendo ser más rápido que HTML o XML.

Sintaxis

La Sintaxis completa de Markdown la encontramos aquí: http://daringfireball.net/projects/markdown/syntax.

PHP

Puedes descargar una librería PHP para Markdown aquí: https://michelf.ca/projects/php-markdown/

Ejemplos

*Esto va en cursiva*

Genera: Esto va en cursiva

*Patatas

*Judías

*Tomates

Genera una lista:

• Patatas
• Judías
• Tomates

Editores

Editor online: Markable -> http://markable.in/editor/

.

 

 

Crear Test en formato GIFT (para subir a Moodle)

GIFT es uno de los múltiples formatos de preguntas test que admite Moodle. Utilizando este formato podrás subir preguntas test por bloques, en lugar de hacerlo de forma lenta y tediosa, una a una.

He encontrado una página que me genera automáticamente el fichero:

http://text2gift.x10.mx/ConversionTextoaGift.html

Ya la tengo en mis favoritos.

Yo tenía mis preguntas test en un fichero de Word, a la hora de subirlo a Moodle, era muy lento, así que gracias a esta página sólo tienes que poner las preguntas en el siguiente formato:

 

¿Cómo era el caballo blanco de Santiago?

azul

verde

*blanco

 

Con el * marcas la respuesta correcta.

Luego, pulsas el botón ENVIAR y se te descargará un fichero que podrás subir automáticamente a Moodle.

El formato GIFT generado tendrá el aspecto:

::Sin código -01. ¿Cómo era el...::¿Cómo era el caballo blanco de Santiago? {
~azul
~verde
=blanco
}

::

Mi hosting gratuito de Moodle en www.milaulas.com

Ya he encontrado un hosting gratuito de Moodle que me satisface.

Lo tienes en www.milaulas.com.

Es justo lo que estaba buscando. Hoy me he creado mi primer curso:

http://auxadmingra.milaulas.com/

 

Tiene publicidad. Es lo que veis con el rectangulito gris, pero no molesta demasiado.

Tiene posibilidad de acceso de invitado (con o sin contraseña), subir ficheros, etc etc.