大网数据广告活动
网站运营与故障问答

How to make markdown files in Git repositories indexable by search engines?

· 52CE 我爱测

If I google "@typescript-eslint no-invalid-void-type", the first search result will be typescript-eslint/no-invalid-void-type.md at main - GitHub , the markdown file in @typescript-eslint repository . This location is pretty deep…

问题原文

原帖链接 · Takeshi Tokugawa YD · CC BY-SA 4.0

If I google "@typescript-eslint no-invalid-void-type", the first search result will be typescript-eslint/no-invalid-void-type.md at main - GitHub, the markdown file in @typescript-eslint repository. This location is pretty deep: packages/eslint-plugin/docs/rules/no-invalid-void-type.md.

However, if I google @yamato-daiwa/es-extensions removeLastCharacter, I'll get No search result (on my language), while this page is exists in directory CoreLibrary/Package/Documentation/Strings/removeLastCharacter.md of Yamato-Daiwa-ES-Extensions monorepository.

Which kind of magic allows @typescript-eslint documentation to be indexed by Google?

Update before start bounty

Unfortunately, the current answer does not explaing why my markup documentaion does not appear in the search results, while similar documentation for @typescript-eslint is being indexed well.

Let the documentation for replaceArrayElementsByPredicates function will be the experimental sample.

First, I tried to use the suggested tool - Google Mobile Friendy Test . The result is "everyting fine":

Sharable link

The name of GitHub repository is "Yamato-Daiwa-ES-Extensions" (there are some limitations that is why I used the n-dashes). Try to search Yamato-Daiwa-ES-Extensions replaceArrayElementsByPredicates. Just one search result, and it is not the GitHub:

The npm name is @yamato-daiwa/es-extensions. Try to search yamato-daiwa/es-extensions replaceArrayElementsByPredicates. Just one result again:

.

The search request is exact as possibe. The google did not indexed this page? I suppose, before to promoute my library, it's documentation must recieve some organic.

已采纳解答

原帖链接 · Mike Ciffone · CC BY-SA 4.0

It is already crawlable and indexable. It is likely the case that Google is not seeing enough signals that it is important for certain queries yet.

I would focus on getting the word out about your (really great) set of tools so people begin sharing it thus earning you backlinks. These are the most fundamental indication of a web page's importance.

The TypeScript repository gets a lot of attention from Google because of its established user base and popularity. Deep pages like the example you provided rank for queries that already enjoy substantial search volume and that is why Google has indexed them.

Take a look at its backlink profile (I'm using Ahrefs).

TypeScript ESLint - Backlink Overview

You can get there too by continuing to do what you do and providing value to the TypeScript community!


What will people search to find your repository?

I also want to take a second to point out that since your repository is still fairly new, people won't be entering Yamato-Daiwa-ES-Extensions replaceArrayElementsByPredicates as their search query.

So you want to optimize the readme.md with the verbiage that they'll be using to search for what your repository is. I would write as much content as you can about what it does, who it is for, and how it provides value for TypeScript engineers/developers.


Immediate actions you may take

I would recommend that you create a web page and on your canonical website with the readme.md content I mentioned and link to/from the GitHub repository and NPM page.

In addition to creating useful content for users, this also helps provide Google with an understanding of what your repository is.

Also, perhaps some blogs about your tools - guides do really great on search. With some additional content you'll be well on your way. Then I would just wait and see what happens.

I would not be worried about duplicate readme content, to me it becomes more accessible. Allow Google to prioritize which one to rank and when. In this case, a user's search history will probably carry a lot of weight in that decision.

摘自公开归档,保留原文语言,版式经整理,外部媒体与邮箱地址已移除。

资料来源与适用范围

资料来源
Webmasters Stack Exchange
适用范围
以原帖系统、软件版本与发布日期为准(2022-01-21)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。