A>_ASCIIForge
ES
Guia

Arte ASCII para GitHub README

Los banners ASCII ayudan a escanear secciones README si son compactos y legibles.

Crear tu README

Usa el banner de arriba, añade los detalles y descarga un archivo Markdown.

Empieza con un ejemplo completo

Elige un proyecto Python sencillo, una biblioteca o una herramienta de terminal. Adapta los textos y comandos a tu proyecto; se conserva tu banner actual.

Proyecto sencillo

Una breve presentación, un comando funcional y notas para contribuir.

Biblioteca Python

Un pequeño módulo reutilizable con un ejemplo de importación.

Herramienta de terminal

Un comando con un archivo de entrada y el resultado esperado.

Descargar los ejemplos funcionales (ZIP, en inglés)

Vista previa del README

Vista previa del README
Markdown completo
Estos campos quedan en esta página y no se incluyen en el enlace del banner. Instalación y uso se copian como código; descripción y contribuciones como texto simple.
Los encabezados ASCII hacen destacar un README
Un README sencillo abre con una línea de texto. Uno genial abre con un banner. El arte ASCII da a tu proyecto un encabezado reconocible, separadores de sección e insignias de estado sin añadir archivos de imagen al repositorio — es solo texto, así que carga al instante y funciona en cualquier visor Git.
Usa siempre un bloque de código
El Markdown de GitHub muestra el texto normal de forma proporcional, lo que destruye la alineación ASCII. Envuelve el arte en un bloque de código para que se muestre en monoespaciado:
```
+------------+
| MY PROJECT |
+------------+
```
Usa un bloque con tres comillas invertidas sin etiqueta de lenguaje para que ningún resaltador de sintaxis recoloree tu arte.
Elige el ancho correcto
Medido con el texto completo, mayúsculas y marco elegidos. Revisa el resultado en el dispositivo de destino.
Dónde usarlo
  • El banner del título del proyecto arriba del todo.
  • Separadores de sección sobre Instalación, Uso y Licencia.
  • Marcadores de estado simples como == BUILD PASSING ==.
  • Un logo ASCII generado desde el icono de tu app.
Mantenlo accesible
Los lectores de pantalla leen el arte ASCII carácter por carácter, así que no escondas información esencial dentro del arte. Mantén un título de texto normal junto al banner para que la página tenga sentido sin él.
Generar un banner para README