Un gran `README.md` es la diferencia entre un proyecto de código abierto exitoso y uno abandonado. Y una de las mejores formas de presentar documentación de API, comparaciones de funciones u opciones de configuración es mediante tablas.
Desafortunadamente, el Markdown estándar no facilita las tablas.
La lucha de la mesa de rebajas
Escribir una tabla Markdown a mano se ve así:
```rebaja | Propiedad | Tipo | Descripción | |---|---|---| | identificación | cadena | El identificador único | | tiempo de espera | número | Tiempo en milisegundos | ```
Si agrega una descripción larga a una fila, toda la tabla queda visualmente desalineada en su editor de código, lo que hace que sea increíblemente difícil de mantener y leer.
Generación Visual
El flujo de trabajo más eficiente es utilizar una cuadrícula visual. Con nuestro [Generador de tablas de rebajas](/en/markdown-table-generator), puedes escribir tu contenido en una interfaz similar a una hoja de cálculo.
Puede agregar columnas, eliminar filas y escribir de forma natural. Una vez que haya terminado, la herramienta genera instantáneamente la sintaxis de Markdown perfectamente espaciada y con un formato limpio. Simplemente cópielo y péguelo en su README.
¡Deja de pelear con barras verticales (`|`) y guiones, y comienza a generar tus tablas visualmente!