.markdownlint-config-info.md

Configuracion de Markdownlint

Este archivo explica cada regla configurada en .markdownlint.json.

Reglas Configuradas

Regla	Estado	Descripcion	Nombre Tecnico
default	true	Habilita todas las reglas por defecto	-
MD007	false	Indentacion de listas desordenadas	ul-indent
MD012	false	Multiples lineas en blanco consecutivas	no-multiple-blanks
MD013	false	Longitud maxima de linea	line-length
MD022	false	Lineas en blanco alrededor de encabezados	blanks-around-headings
MD024	false	Multiples encabezados con el mismo contenido	no-duplicate-heading
MD025	false	Multiples encabezados de nivel superior	single-title/single-h1
MD029	false	Estilo de numeracion de listas ordenadas	ol-prefix
MD032	false	Lineas en blanco alrededor de listas	blanks-around-lists
MD033	false	HTML en linea permitido	no-inline-html
MD034	false	URLs desnudas sin formato markdown	no-bare-urls
MD036	false	Enfasis usado como encabezado	no-emphasis-as-heading
MD045	false	Imagenes deben tener texto alternativo	no-alt-text
MD050	false	Estilo de enfasis fuerte (asterisco vs guion bajo)	strong-style
MD051	false	Fragmentos de enlaces deben ser validos	link-fragments
MD058	true	Tablas deben estar rodeadas de lineas en blanco	tables-pipe-style

Explicacion Detallada

MD007 - Indentacion de listas desordenadas

Desactivado porque el proyecto usa formato VSCode Notebook que tiene indentacion de 3 espacios.

MD012 - Multiples lineas en blanco consecutivas

Desactivado para permitir espaciado visual entre secciones grandes en documentacion extensa.

MD013 - Longitud maxima de linea

Desactivado para permitir lineas descriptivas largas en documentacion sin partir artificialmente el contenido.

MD022 - Lineas en blanco alrededor de encabezados

Desactivado para mayor flexibilidad en el formato de documentacion.

MD024 - Multiples encabezados con el mismo contenido

Desactivado porque es valido tener encabezados duplicados en diferentes secciones.

MD025 - Multiples encabezados de nivel superior

Desactivado para permitir multiples h1 en documentos largos.

MD029 - Estilo de numeracion de listas ordenadas

Desactivado para permitir diferentes estilos de numeracion segun el contexto.

MD032 - Lineas en blanco alrededor de listas

Desactivado para mayor flexibilidad en el formato de listas.

MD033 - HTML en linea

Desactivado porque el proyecto usa badges HTML y otros elementos HTML en markdown.

MD034 - URLs desnudas

Desactivado para permitir URLs directas sin necesidad de sintaxis markdown [texto](url).

MD036 - Enfasis como encabezado

Desactivado para permitir texto enfatizado que podria parecer un encabezado.

MD045 - Texto alternativo en imagenes

Desactivado porque algunos badges de shields.io no requieren alt text descriptivo.

MD050 - Estilo de enfasis fuerte

Desactivado para permitir tanto **texto** como __texto__ segun el contexto.

MD051 - Fragmentos de enlaces

Desactivado porque algunos enlaces a secciones pueden no validarse correctamente.

MD058 - Formato de tablas

Activado para mantener un formato consistente de tablas con lineas en blanco alrededor.

Referencias

• Documentacion oficial de markdownlint
• Archivo de configuracion: .markdownlint.json