Currently, when any plugin gets published on the plugin marketplace. For the plugin info page, the content of the GitHub repository README.md file is being shown. Instead of using the main README.md file, there can be a separate markdown file, say plugin-readme.md. Using which, we can fine-tune the content for specifically the marketplace.
The main README.md is usually created for GitHub repository, where we add information for GitHub users to see. Such as, what kind of project it is, or like Contribution section and other types of various information.
But, the information which should be shown in the plugin information page, needs to be a little different. It shouldn’t have so many sections which we add for GitHub users to see, and this page shouldn’t have the section on how to install, since there is already an Install button on the top. (The installation section should be only for users who visit the GitHub repository). And this plugin information page should also have section, like how to use the plugin, initial setup and all, and few other details.
These changes can help a developer on how the information is presented on the GitHub repository and on plugin information page, to gain attention of the users.
If there is no plugin-readme.md file found in the repo, the Obsidian server can fall back on the README.md file. Because all the plugins which has been already published, those developers might not be aware of this change.