explaingit

guodongxiaren/readme

7,034Audience · developerComplexity · 1/5Setup · easy

TLDR

A Chinese-language reference guide showing GitHub Flavored Markdown syntax side-by-side with rendered examples, covering headings, tables, code blocks, images, emoji, anchor links, and collapsible HTML sections.

Mindmap

mindmap
  root((readme guide))
    Text Formatting
      Headings six levels
      Bold italic
      Strikethrough
      Inline code
    Lists and Tables
      Ordered lists
      Checkbox lists
      Tables aligned
    Links and Media
      Images
      Hyperlinks
      Anchor links
      Emoji shortcodes
    Advanced
      Code blocks
      Diff syntax
      Collapsible sections
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Look up the correct syntax for adding a table with aligned columns to a GitHub README.

USE CASE 2

Find how to embed an image from inside a repository or create an anchor link to jump within a page.

USE CASE 3

Copy the syntax for checkbox task lists useful for tracking progress in GitHub issues.

USE CASE 4

Learn how to add a collapsible section or centered content using HTML tags inside a GitHub README.

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

This repository is a reference guide for GitHub Flavored Markdown, written in Chinese. Its purpose is to demonstrate the syntax used to write README files on GitHub, with working examples showing both the code and the rendered result side by side. GitHub Flavored Markdown is an extended version of the standard Markdown format. It adds features that plain Markdown does not have, and is used not just in README files but also in GitHub issues, comments, and wikis. This guide covers all the major formatting options. The guide walks through horizontal lines, six levels of headings, text formatting options like bold, italic, and strikethrough, line breaks, inline code highlighting, block quotes, code blocks with syntax highlighting for languages like Java, JavaScript, C, and Bash, and tables with alignment options. It also covers ordered lists, unordered lists, and checkbox lists, which are particularly useful for tracking task completion in GitHub issues. Beyond standard Markdown, the guide covers embedding images from the web or from within a repository, creating text hyperlinks and image links, using anchor links to jump to sections within the same page, and adding emoji using GitHub shortcode syntax. There is also a section on the diff syntax, which displays added and removed lines in color, and a section on useful HTML tags like collapsible sections and centered content. The repository is primarily a learning reference and demonstration file rather than a software project. All examples are written in Chinese.

Copy-paste prompts

Prompt 1
Show me the GitHub Flavored Markdown syntax for a table with left, center, and right-aligned columns.
Prompt 2
How do I add a collapsible details section to a GitHub README using the HTML details and summary tags?
Prompt 3
What is the GitHub Markdown syntax for a checkbox task list I can use to track to-dos in an issue?
Prompt 4
How do I embed an image stored inside my GitHub repository into the README file with a relative path?
Prompt 5
Show me how to use GitHub Markdown diff syntax in a code block to display added and removed lines in color.
Open on GitHub → Explain another repo

← guodongxiaren on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.