QuiczDown

QuizDown es un formato propio muy sencillo para crear preguntas teniendo en cuenta la legibilidad humana. Se compone de 3 secciones:

flowchart TB
  A(Pregunta) --> B(Opciones posibles de respuesta) --> C(Metadatos)

A continuación se muestra un ejemplo de una pregunta en formato .qd:

¿QuizDown está basado e inspirado en?

+ markdown
+ QUICZ
- html

La pregunta y las opciones pueden contener sintaxis markdown, excepto:

Listas desordenadas,
y Definiciones de enlaces de referencia.

Las opciones posibles de respuesta son una lista desordenada:

Si se usa la viñeta ‘+’ la respuesta es correcta,
Si se usa la viñeta ‘-’ la respuesta es incorrecta,
Si hay mas de una respuesta correcta; la pregunta se tratará como de selección múltiple,

Metadatos

En la parte inferior de una pregunta se pueden incluir metadatos, usando definiciones de enlaces de referencia:

[hint]: pista
[draft]: false
[points]: 1
[difficulty]: 1
[category]: languague
[tags]: markdown, python

hint (pista): Las preguntas pueden incluir (una pista) un mensaje de texto en cursiva,
draft (borrador) - Default = False: De valor booleano, en caso de ser true la pregunta será omitida,
points (puntos) - Default = 1: De valor entero (incluyendo 0 y números negativos), determina la valoración de una pregunta:

Valorar una pregunta con 0 puntos puede servir para incluir preguntas demo sin valor en la evaluación,
Si ingresa un número negativo, se penalizará (deduciría puntos) por respuestas incorrectas,

Las preguntas demo son añadidas en todas las versiones; al inicio del examen o de la sección según corresponda.

difficulty (dificultad) - Default = 1 (Intermediate) Fase 2

Especifica la dificultad de una pregunta:

Beginner (Principiante)
Intermediate (Intermedio)
Advanced (Avanzado)
Expert (Experto)
Master (Maestro)

category

Para asignar una categoría a la pregunta y organizar el examen en secciones (si se solicita),

tags

Para crear mensajes automaticos de retroalimentación de acuerdo al rendimiento,

Del mismo modo, en la parte inferior del archivo header.md se pueden establecer variables y metadatos del examen.

[logo]: file.jpg
[school]: Escuela
[subject]: Asignatura
[teacher]: Profesor
[title]: Título del examen
[date]: 10-10-2023

[valuation]: 50
[penalty]: False
[rounded]: False
[subtraction]: False

valuation (puntos de valuación): De valor entero, es el puntaje máximo de evaluación que se puede obtener; se usa para calcular el puntaje de evaluación de la sig. forma:

Por default será igual al puntaje máximo,

$$ evaluación = \overbrace{valuation}^{\text{puntos de valuación}} \left( { \overbrace{aciertos}^{\text{puntos obtenidos}} - \overbrace{penalizaciones}^{\text{puntos perdidos}} } \over \text{puntaje máximo} \right)$$

penalty (penalizar respuestas incorrectas) - Default = False: De valor booleano, en caso de ser true penalizará todas las respuestas incorrectas, para desalentar las conjeturas aleatorias y fomentar una consideración cuidadosa antes de responder,
rounded (redondear evaluación) - Default = False: De valor booleano, en caso de ser true redondeará el puntaje de evaluación a un número entero,

Por default el puntaje de evalución se redondea a un número flotante de 2 decimales,

subtraction (evaluación sustractiva) - Default = False: De valor booleano, en caso de ser true realizará una evaluación sustractiva, es decir:

Se aplicará una penalización estricta, es decir, se penalizará por igual respuestas incorrectas y omisiones. Para este caso, el metadato penalty no tiene ningun efecto,
El puntaje de evaluación sustractiva se calculará de la sig. forma:

$$ \text{evaluación sustractiva} = evaluación - \overbrace{valuation}^{\text{puntos de valuación}} $$

Caracteristicas

Escritura perezosa; .qd permite la escritura diferida, lo que significa que el siguiente formato también será válido:

¿QuiczDown está basado
   e inspirado en?

+ el formato
markdown
- html

Existen otros formatos similares, cómo:

Formato Aiken de Moodle,