Generador de README

Rellena un formulario corto y obtén un README.md completo para tu proyecto: descripción, características, instalación, uso, contribuir, licencia y autor, con insignias e índice. Revísalo en la vista previa y cópialo a GitHub.

  • Usos diarios gratis
  • Funciona en tu navegador
  • Sin registro

Última actualización:

Plan: FreeVer paquetes →

Se hace en tu navegador. Nada de lo que escribes se sube.

Te quedan 100 de 100 operaciones hoy
README.md
Proyecto
El idioma de los títulos y frases estándar del README.
Descripción
Aquí funciona Markdown.
Una por línea.
Instalación y uso
Comandos, uno por línea. Si lo dejas vacío y hay un paquete npm, se escribe npm install con el nombre del paquete.
Aquí funciona Markdown: pon el código entre líneas de ```.
Contribuir
Licencia y autor
Aquí funciona Markdown.

Ponle un nombre a tu proyecto para ver aquí su README.

Copiar o descargar el README cuenta como una operación Markdown. Rellenar el formulario es gratis.

Guía

Cómo crear un README

Tres pasos de un formulario a un README.md para tu proyecto.

  1. Describe tu proyecto

    Ponle un nombre y una descripción de una línea. Añade el repositorio de GitHub y el paquete npm si los tienes, elige el idioma del README y deja activados Insignias e Índice si los quieres. Haz clic en Ejemplo para ver uno.

    La parte del proyecto del formulario con nombre, descripción, repositorio de GitHub, paquete npm, idioma del README, insignias e índice.La parte del proyecto del formulario con nombre, descripción, repositorio de GitHub, paquete npm, idioma del README, insignias e índice.
  2. Rellena las secciones

    Escribe qué hace el proyecto, sus características (una por línea), los comandos de instalación y un ejemplo. Elige una licencia y añade tu nombre. Las secciones vacías se omiten.

    Las secciones del formulario: Acerca de, Características, Instalación y Uso, rellenadas para el proyecto de ejemplo.Las secciones del formulario: Acerca de, Características, Instalación y Uso, rellenadas para el proyecto de ejemplo.
  3. Copia el README

    El README se actualiza mientras escribes. Cambia a Vista previa para verlo como en GitHub y haz clic en Copiar README o Descargar y guárdalo como README.md.

    La vista previa del README de ejemplo con insignias, descripción, índice y secciones.La vista previa del README de ejemplo con insignias, descripción, índice y secciones.

Conviene saber

  • No se sube nadaTu README se crea en tu navegador y nunca sale de tu dispositivo.
  • Rellenar es gratisSolo copiar o descargar el README cuenta como una operación Markdown.
  • Añade un archivo LICENSELa sección Licencia enlaza a él; GitHub puede crearlo a partir de sus plantillas.

Preguntas frecuentes

¿Qué incluye el README?

El nombre del proyecto y una descripción de una línea, y después las secciones que rellenes: Acerca de, Características, Instalación, Uso, Captura de pantalla, Contribuir, Licencia, Autor y Agradecimientos. Las secciones vacías se omiten, así que el README solo tiene lo que tu proyecto necesita.

¿Puede estar el README en otro idioma?

Sí. Elige inglés, español, alemán o francés como idioma del README: los títulos y las frases estándar de Contribuir, Licencia y Autor se escriben en ese idioma. Lo que escribes tú se mantiene tal cual.

¿Qué son las insignias?

Pequeñas etiquetas arriba del README para la licencia, la versión de npm y las estrellas de GitHub. Son imágenes de shields.io que GitHub muestra; nuestra vista previa las enseña como recuadros en lugar de cargarlas. Añade un repositorio de GitHub o un paquete npm para tener esas insignias.

¿Dónde pongo el archivo?

Guárdalo como README.md en la carpeta principal de tu proyecto: GitHub, GitLab y npm lo muestran en la portada del proyecto. La sección Licencia enlaza a un archivo LICENSE; GitHub puede crearlo por ti a partir de sus plantillas de licencia.

¿Se sube algo y qué cuenta como un uso?

No, el README se crea en tu navegador y lo que escribes nunca sale de tu dispositivo. Rellenar el formulario es gratis: solo copiar o descargar el README cuenta como una operación del límite diario que se muestra encima de la herramienta. Nuestro servidor solo registra ese recuento y tu dirección de red.

Más herramientas Markdown