Générateur de README

Remplissez un court formulaire et obtenez un README.md complet pour votre projet : description, fonctionnalités, installation, utilisation, contribution, licence et auteur, avec badges et sommaire. Vérifiez-le dans l'aperçu et copiez-le sur GitHub.

  • Utilisations gratuites chaque jour
  • Fonctionne dans votre navigateur
  • Sans inscription

Dernière mise à jour :

Offre : FreeVoir les offres →

Créé dans votre navigateur. Rien de ce que vous saisissez n'est envoyé.

Il vous reste 100 opérations sur 100 aujourd'hui
README.md
Projet
La langue des titres et des phrases standard du README.
Description
Le Markdown fonctionne ici.
Une par ligne.
Installation et utilisation
Commandes, une par ligne. Laissé vide avec un paquet npm, on y lit npm install suivi du nom du paquet.
Le Markdown fonctionne ici : mettez le code entre des lignes de ```.
Contribuer
Licence et auteur
Le Markdown fonctionne ici.

Donnez un nom à votre projet pour voir son README ici.

Copier ou télécharger le README compte comme une opération Markdown. Remplir le formulaire est gratuit.

Guide

Comment créer un README

Trois étapes d'un formulaire à un README.md pour votre projet.

  1. Décrivez votre projet

    Donnez-lui un nom et une description en une ligne. Ajoutez le dépôt GitHub et le paquet npm si vous en avez, choisissez la langue du README et gardez Badges et Sommaire si vous les voulez. Cliquez sur Exemple pour en voir un.

    La partie projet du formulaire avec nom, description, dépôt GitHub, paquet npm, langue du README, badges et sommaire.La partie projet du formulaire avec nom, description, dépôt GitHub, paquet npm, langue du README, badges et sommaire.
  2. Remplissez les sections

    Écrivez ce que fait le projet, listez ses fonctionnalités (une par ligne), les commandes d’installation et un exemple. Choisissez une licence et ajoutez votre nom. Les sections vides sont laissées de côté.

    Les sections du formulaire : À propos, Fonctionnalités, Installation et Utilisation, remplies pour le projet d'exemple.Les sections du formulaire : À propos, Fonctionnalités, Installation et Utilisation, remplies pour le projet d'exemple.
  3. Copiez le README

    Le README se met à jour pendant la saisie. Passez à Aperçu pour le voir comme sur GitHub, puis cliquez sur Copier le README ou Télécharger et enregistrez-le sous README.md.

    L'aperçu du README d'exemple avec badges, description, sommaire et sections.L'aperçu du README d'exemple avec badges, description, sommaire et sections.

Bon à savoir

  • Rien n'est envoyéVotre README est créé dans votre navigateur et ne quitte jamais votre appareil.
  • Remplir est gratuitSeuls la copie ou le téléchargement du README comptent comme une opération Markdown.
  • Ajoutez un fichier LICENSELa section Licence y renvoie ; GitHub peut le créer à partir de ses modèles.

Questions fréquentes

Que contient le README ?

Le nom du projet et une description en une ligne, puis les sections que vous remplissez : À propos, Fonctionnalités, Installation, Utilisation, Capture d'écran, Contribuer, Licence, Auteur et Remerciements. Les sections vides sont laissées de côté : le README ne contient que ce dont votre projet a besoin.

Le README peut-il être dans une autre langue ?

Oui. Choisissez l'anglais, l'espagnol, l'allemand ou le français comme langue du README : les titres et les phrases standard de Contribuer, Licence et Auteur sont écrits dans cette langue. Ce que vous saisissez vous-même reste tel quel.

Que sont les badges ?

De petites étiquettes en haut du README pour la licence, la version npm et les étoiles GitHub. Ce sont des images de shields.io que GitHub affiche ; notre aperçu les montre comme des cadres au lieu de les charger. Indiquez un dépôt GitHub ou un paquet npm pour obtenir ces badges.

Où mettre le fichier ?

Enregistrez-le sous le nom README.md dans le dossier principal de votre projet : GitHub, GitLab et npm l'affichent sur la page d'accueil du projet. La section Licence renvoie à un fichier LICENSE ; GitHub peut le créer pour vous à partir de ses modèles de licence.

Quelque chose est-il envoyé, et qu'est-ce qui compte comme une utilisation ?

Non, le README est créé dans votre navigateur et ce que vous saisissez ne quitte jamais votre appareil. Remplir le formulaire est gratuit : seuls la copie ou le téléchargement du README comptent comme une opération dans la limite quotidienne affichée au-dessus de l'outil. Notre serveur enregistre seulement ce compte et votre adresse réseau.

Autres outils Markdown