为什么标题会在GitHub readme.md markdown页面中自动创建链接?

如何解决为什么标题会在GitHub readme.md markdown页面中自动创建链接?

您好:我已经为我的存储库和GitHub页面创建了readme.md文件。但是,当我创建格式为h2 / ##或h3 / ###等的标题时,会自动创建页内定位链接。我尝试了各种格式设置标题的方式,例如##,,---,但是得到的结果相同。它出现在每个标题上。这会在存储库中的readme.md文件中以及转换为GitHub页面的文件中发生。我已经在chrome浏览器和Edge浏览器中对其进行了测试,这是相同的行为。

# sample将创建标题和不需要的页内链接

## sample将创建标题和不需要的页内链接

这是一个行为如下的页面:https://burrittresearch.com/

我的目标是能够在markdown中格式化标题,而无需自动创建这些链接。

谢谢!

解决方法

这些是GitHub页面上anchorjs默认CSS规则的一部分

<h2 id="skills">Skills
  <a class="anchorjs-link" 
     href="#skills" 
     aria-label="Anchor" 
     data-anchorjs-icon="" 
     style="font: 1em / 1 anchorjs-icons; padding-left: 0.375em;">
  </a>
</h2>

如果您的静态页面(如this one)包含其自己的CSS文件/规则集(如those ones),则可以添加以确保它们不可见:

.anchorjs-link {
  display: none !Important;
}
,

GitHub在github/Markup中记录了其标记处理。请注意,Markdown在第一步中转换为HTML,该过程不会在标头中添加任何锚点。但是,在与Markdown解析分开的步骤4中,文档中的所有标头都添加了锚点。不论是否来自Markdown,ReStructured Text,纺织品,asscidoc等,所有内容都会完成此操作,并且不特定于Markdown。

请注意,以上内容仅适用于在github.com上显示的用户提供的内容。这是他们控制的网站,因此我们不必更改/覆盖该行为。

但是,与GitHub页面不同。默认情况下,GitHub Pages使用Jekyll将Markdown文件转换为HTML。 Jekyll包括多个options,以控制Markdown的处理方式,包括auto_ids选项。关闭该选项(将其设置为false),Jekyll将不再向每个标头添加ID。但是,这是一个Kramdown选项,但是据我了解,GitHub Pages使用Commonmark的GitHub Flavored Markdown变体,它没有任何此类选项。因此,GFM规范也没有指出标头也不会分配ID(因此我不确定这些ID的来源)。您可以尝试将Jekyll配置为在auto_ids选项关闭的情况下使用Kramdown。 Configuration options“可以在网站根目录中的_config.yml_config.toml文件中指定。”

或者,您可以在本地安装Jekyll(或任何其他static site generator)并构建网站,然后再上传到GitHub Pages。只需在站点根目录中包含一个名为.nojekyll的空文件,GitHub就不会通过Jekyll运行您的文件。这样,您就可以完全控制页面的内容和格式。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


依赖报错 idea导入项目后依赖报错,解决方案:https://blog.csdn.net/weixin_42420249/article/details/81191861 依赖版本报错:更换其他版本 无法下载依赖可参考:https://blog.csdn.net/weixin_42628809/a
错误1:代码生成器依赖和mybatis依赖冲突 启动项目时报错如下 2021-12-03 13:33:33.927 ERROR 7228 [ main] o.s.b.d.LoggingFailureAnalysisReporter : *************************** APPL
错误1:gradle项目控制台输出为乱码 # 解决方案:https://blog.csdn.net/weixin_43501566/article/details/112482302 # 在gradle-wrapper.properties 添加以下内容 org.gradle.jvmargs=-Df
错误还原:在查询的过程中,传入的workType为0时,该条件不起作用 &lt;select id=&quot;xxx&quot;&gt; SELECT di.id, di.name, di.work_type, di.updated... &lt;where&gt; &lt;if test=&qu
报错如下,gcc版本太低 ^ server.c:5346:31: 错误:‘struct redisServer’没有名为‘server_cpulist’的成员 redisSetCpuAffinity(server.server_cpulist); ^ server.c: 在函数‘hasActiveC
解决方案1 1、改项目中.idea/workspace.xml配置文件,增加dynamic.classpath参数 2、搜索PropertiesComponent,添加如下 &lt;property name=&quot;dynamic.classpath&quot; value=&quot;tru
删除根组件app.vue中的默认代码后报错:Module Error (from ./node_modules/eslint-loader/index.js): 解决方案:关闭ESlint代码检测,在项目根目录创建vue.config.js,在文件中添加 module.exports = { lin
查看spark默认的python版本 [root@master day27]# pyspark /home/software/spark-2.3.4-bin-hadoop2.7/conf/spark-env.sh: line 2: /usr/local/hadoop/bin/hadoop: No s
使用本地python环境可以成功执行 import pandas as pd import matplotlib.pyplot as plt # 设置字体 plt.rcParams[&#39;font.sans-serif&#39;] = [&#39;SimHei&#39;] # 能正确显示负号 p
错误1:Request method ‘DELETE‘ not supported 错误还原:controller层有一个接口,访问该接口时报错:Request method ‘DELETE‘ not supported 错误原因:没有接收到前端传入的参数,修改为如下 参考 错误2:cannot r
错误1:启动docker镜像时报错:Error response from daemon: driver failed programming external connectivity on endpoint quirky_allen 解决方法:重启docker -&gt; systemctl r
错误1:private field ‘xxx‘ is never assigned 按Altʾnter快捷键,选择第2项 参考:https://blog.csdn.net/shi_hong_fei_hei/article/details/88814070 错误2:启动时报错,不能找到主启动类 #
报错如下,通过源不能下载,最后警告pip需升级版本 Requirement already satisfied: pip in c:\users\ychen\appdata\local\programs\python\python310\lib\site-packages (22.0.4) Coll
错误1:maven打包报错 错误还原:使用maven打包项目时报错如下 [ERROR] Failed to execute goal org.apache.maven.plugins:maven-resources-plugin:3.2.0:resources (default-resources)
错误1:服务调用时报错 服务消费者模块assess通过openFeign调用服务提供者模块hires 如下为服务提供者模块hires的控制层接口 @RestController @RequestMapping(&quot;/hires&quot;) public class FeignControl
错误1:运行项目后报如下错误 解决方案 报错2:Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project sb 解决方案:在pom.
参考 错误原因 过滤器或拦截器在生效时,redisTemplate还没有注入 解决方案:在注入容器时就生效 @Component //项目运行时就注入Spring容器 public class RedisBean { @Resource private RedisTemplate&lt;String
使用vite构建项目报错 C:\Users\ychen\work&gt;npm init @vitejs/app @vitejs/create-app is deprecated, use npm init vite instead C:\Users\ychen\AppData\Local\npm-