Buenas prácticas · Autoría MDW

Buenas prácticas para crear documentos MDW con agentes

Un .mdw es un contrato de publicación, no Markdown con otro nombre. La autoría fiable hace comprobable la relación entre afirmaciones, estructura, presentación, activos y evidencia.

Actualizado 3 de agosto de 2026Guía práctica

Parte de la tarea del lector

Elige report, article, briefing o dashboard según la lectura, ordena conclusión y evidencia antes del estilo y usa un tema y biblioteca de iconos compatibles.

Explicita datos y presentación

Los números importantes deben vivir en hechos tipados o resultados de consulta; tablas, métricas y gráficos los referencian, no los esconden en texto decorativo.

Trata los medios como evidencia

Fija los bytes en el paquete y registra fuente, autor, licencia, fecha, digest, alt, pie y crédito; una imagen fallida no debe impedir entender el documento.

Pasa las puertas deterministas

Ejecuta check, build y digest en ese orden. Si algo falla, vuelve al draft y reconstruye; no retoques el archivo empaquetado.

ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw

Preguntas

Preguntas frecuentes

¿.mdw es solo otra extensión de Markdown?

No. Es un paquete tipado y determinista con contenido, presentación, activos y metadatos.

¿Puedo incluir cualquier HTML o JavaScript?

No. Solo nodos tipados y capacidades de renderizado admitidos.

Usa el flujo real

Publica lo que crea tu agente.

Da a cada informe, documento o plan una página lista para sus lectores, desde la que vuelvan comentarios, decisiones y revisiones formales.