Este artículo es la guía de referencia de los formatos y bloques técnicos disponibles en Fivur. La base sigue siendo Markdown limpio: un artículo corto puede usar solo párrafos y un bloque de código, mientras que una guía profunda puede incorporar esquemas, prácticas locales o preguntas de verificación.
§ Palabras con intención y formato básico
Puedes escribir en negrita, usar cursivas, subrayar un término puntual, tachar una idea descartada o mencionar un comando en línea como git status. Para una frase que merezca atención especial, existe la selección de terminal: una idea que se queda contigo.
Los enlaces internos y los enlaces externos conservan el acento verde. También puedes utilizar listas de tareas estándar:
- Definir metadatos YAML o JSON al inicio del archivo
- Escribir el contenido progresivamente en Markdown
- Añadir componentes técnicos solo cuando aporten claridad
§ Tres formas de citar
La cita clásica usa un borde verde y el carácter >, como una línea respondida en una conversación:
[object Object]
También puedes incluir una atribución:
El cursor espera. La siguiente línea es tuya.
— Nota editorial · fivur blog
Para una idea central, una cita destacada puede darle una pausa al artículo:
Hacer espacio también
principio de lectura
es una forma de diseñar.
§ Notas técnicas (`Info`, `Tip`, `Warning`, `Important`)
Las notas complementan un párrafo sin romper el hilo de lectura. Puedes escribirlas con bloques :::tipo o en HTML:
Usa el bloque info para definiciones, aclaraciones de protocolo o detalles que ayudan a situar el resto del texto.
Usa el bloque tip para atajos, banderas útiles de comandos o buenas prácticas comprobadas.
Las advertencias tienen un acento ámbar discreto. Resérvalas para limitaciones o pasos que conviene revisar con cuidado.
§ Bloques de código (`CodeBlock`) y terminal (`TerminalBlock`)
Los bloques de código muestran el lenguaje en su cabecera, resaltan la sintaxis de forma sutil y permiten copiar el contenido con un clic:
const temas = ["fundamentos", "redes", "linux", "ciberseguridad"];
for (const tema of temas) {
console.log(`> explorando: ${tema}`);
}Para sesiones de línea de comandos, el bloque terminal distingue entre comandos ejecutables (precedidos por $ ) y la salida del sistema, permitiendo copiar únicamente los comandos:
# Crear un directorio de notas y verificar su contenido
mkdir -p ~/notas
printf '# Primera nota\n' > ~/notas/idea.md
cat ~/notas/idea.md
# Primera nota§ Esquemas y diagramas (`DiagramBlock`)
Puedes incluir esquemas técnicos tanto en texto estructurado como en gráficos vectoriales SVG adaptables a móvil:
§ Prácticas, autoevaluación y checklists
Publicar un nuevo artículo en Fivur
Para añadir una publicación sin tocar el código del generador:
- Crea un archivo
.mddentro de la carpetacontent/(por ejemplo,content/analisis-dns.md). - Escribe la cabecera YAML con
title,description,date,categoryytags. - Ejecuta
npm run build: la portada, la página de la categoría, los contadores, el archivo, el buscador y el feed RSS se actualizarán automáticamente.
¿Cuándo conviene añadir componentes interactivos (como un quiz, una práctica o una tabla de contenidos) a un artículo de Fivur?
§ Tabla de referencia rápida
| Componente | Sintaxis en Markdown | Cuándo usarlo |
|---|---|---|
CodeBlock |
```lenguaje:archivo |
Fragmentos de código o archivos de configuración |
TerminalBlock |
```terminal:título |
Comandos con salida de ejemplo en consola |
Callout |
:::info, :::tip, :::warn |
Notas al margen, consejos y advertencias |
PracticeBlock |
:::practice Título | Tiempo | Nivel |
Pequeños laboratorios reproducibles en el PC |
QuizBlock |
```quiz |
Preguntas de autoevaluación con explicación |
ChecklistBlock |
```checklist:Título |
Criterios para verificar si se domina el tema |