Even if not general purpose, I would think a markdown editor would suffice.

I could have posed the question better. But, I haven't found one that served my needs yet. Nor do I not know of one that may have interesting features that would make it easier to do things, like maybe adding shields/badges/assets within automatically or being able to create a directory like structure by generating new MD files when wanting to create a comprehensive API doc.

READMEs aren't necessarily markdown. That is the most popular option, but there's others out there. Here's Github's list of supported README formats for example:

The following markups are supported. The dependencies listed are required if you wish to run the library. You can also run script/bootstrap to fetch them all.

• .markdown, .mdown, .mkdn, .md -- gem install commonmarker (https://github.com/gjtorikian/commonmarker)
• .textile -- gem install RedCloth (https://github.com/jgarber/redcloth)
• .rdoc -- gem install rdoc -v 3.6.1
• .org -- gem install org-ruby (https://github.com/wallyqs/org-ruby)
• .creole -- gem install creole (https://github.com/larsch/creole)
• .mediawiki, .wiki -- gem install wikicloth (https://github.com/nricciar/wikicloth)
• .rst -- pip install docutils
• .asciidoc, .adoc, .asc -- gem install asciidoctor (http://asciidoctor.org)
• .pod -- Pod::Simple::XHTML comes with Perl >= 5.10. Lower versions should install Pod::Simple from CPAN.

Yeah, have been using text editor mainly for markdown editing or other lightweight WYSIWYG apps, it's good enough. Felt, there could be more out there that I am missing out on which I am unaware of.

Haven't thought of this yet, thanks

VS Code's extension system makes it pretty easy to build your own code snippet extension. I use my own private extension to easily "generate" different types of markdown files (ie readme vs a troubleshooting guide) from my personalized snippets.

A lot of people seem to have misunderstood the question and are offering text editors. Apostrophe as actually looks like it fits the bill for a decent markdown editor, which is what OP seems to have been asking for

Typora is really cool, wish it was OS though. Although the one-time purchase isn't too bad

Essentially what I was thinking,

Is an IDE like environment just for markdown file management and WYSIWYG editing experience

More like a notes/personal wiki app, than a readme editor.

That said, Obsidian is a diamond in the rough. Building a personal wiki while learning a skill and referencing it later (via search or category) is a true life hack. It feels like augmenting your memory capacity.

Truly invaluable if you need to reference things often but your knowledge base is highly specialized (e.g., I'm a neurology professor)