我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

Managing your profile README

You can add a README to your GitHub profile to tell other people about yourself.

本文内容

Did this doc help you?

About your profile README

You can share information about yourself with the community on GitHub by creating a profile README. GitHub shows your profile README at the top of your profile page.

You decide what information to include in your profile README, so you have full control over how you present yourself on GitHub. Here are some examples of information that visitors may find interesting, fun, or useful in your profile README.

  • An "About me" section that describes your work and interests
  • Contributions you're proud of, and context about those contributions
  • Guidance for getting help in communities where you're involved

Profile README file displayed on profile

You can format text and include emoji, images, and GIFs in your profile README by using GitHub Flavored Markdown. 更多信息请参阅“在 GitHub 上编写和设置格式”。

基本要求

GitHub will display your profile README on your profile page if all of the following are true.

  • You've created a repository with a name that matches your GitHub username.
  • The repository is public.
  • The repository contains a file named README.md in its root.
  • The README.md file contains any content.

Note: If you created a public repository with the same name as your username before July 2020, GitHub won't automatically show the repository's README on your profile. You can manually share the repository's README to your profile by going to the repository on GitHub.com and clicking Share to profile.

Button to share README to profile

Adding a profile README

  1. 在任何页面的右上角,使用 下拉菜单选择 New repository(新建仓库)

    带有创建新仓库选项的下拉菜单

  2. Under "Repository name", type a repository name that matches your GitHub username. For example, if your username is "octocat", the repository name must be "octocat".

    Repository name field which matches username

  3. (可选)添加仓库的说明。 For example, "My personal repository."

    用于输入仓库说明的字段

  4. Select Public.

    Radio button to select visibility with public selected

  5. 选择 Initialize this repository with a README(使用自述文件初始化此仓库)

    使用自述文件初始化此仓库复选框

  6. Click Create repository.

    Button to create repository

  7. Above the right sidebar, click Edit README.

    Button to edit README file

    The generated README file is pre-populated with a template to give you some inspiration for your profile README.

    README file with pre-populated template

Removing a profile README

The profile README is removed from your GitHub profile if any of the following apply:

  • The README file is empty or doesn't exist.
  • The repository is private.
  • The repository name no longer matches your username.

The method you choose depends upon your needs, but if you're unsure, we recommend making your repository private. For steps on how to make your repository private, see "Changing a repository's visibility."

延伸阅读

Did this doc help you?