GitHub README.md中URL仅显示标题失效 直接展示纯代码

• 优先检查基础语法格式：标准可渲染链接的写法为 [你要展示的链接标题](实际跳转的URL地址)，方括号和紧跟的圆括号之间不能有任何空格，也不能使用全角的方括号/圆括号，否则语法会直接失效，原样展示文本内容。
  • 失效写法举例：

    // 方括号和圆括号之间加了空格
    [项目说明文档] (你的项目文档实际链接地址)
    // 误用全角符号
    ［项目说明文档］(你的项目文档实际链接地址)
    

  • 正确写法举例：

    [项目说明文档](你的项目文档实际链接地址)
    

• 检查链接所在位置的上下文格式：
  • 如果链接写在代码块（首尾被三个反引号包裹）、行内代码（被单个反引号包裹）、行首带4个及以上空格的代码段里，所有Markdown语法都会失效，内容会原样展示。
  • 如果链接写在列表、引用块的嵌套内容中，需要保证链接所在行和列表项/引用块的起始文本保持2个空格的缩进，缩进不规范会导致整段格式解析错乱。
• 检查链接地址合法性：如果URL本身包含未转义的空格、半角括号等特殊字符，会导致Markdown解析时语法截断，需要先对URL做编码处理再填入括号中。
• 刚推送到仓库的README如果显示异常，先强制刷新页面，GitHub的渲染服务存在短时间缓存，一般等待1分钟内刷新即可看到正确渲染效果。

内容的提问来源于stack exchange，提问作者abd