What's everyone's favorite README editor? (lemmy.world)

submitted 11 months ago* (last edited 11 months ago) by pexavc@lemmy.world to c/opensource@lemmy.ml

32 comments fedilink hide all child comments

Looking for a good README editor. With maybe git functionality, but not necessary

Like adding shields/badges/assets within automatically
managing a directory like structure by generating new MD files in a directory like folder structure.

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

you are viewing a single comment's thread
view the rest of the comments

[-] gomp@lemmy.ml 24 points 11 months ago

Don't you mean a markdown editor?

Chances are, your favorite text editor can handle markdown well enough... unless you want WYSIWYG, in which case your text editor would still be good enough for the job and you would be wrong :-)

[-] BitSound@lemmy.world 2 points 11 months ago

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.

[-] pexavc@lemmy.world 1 points 11 months ago

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.

[-] gomp@lemmy.ml 2 points 11 months ago

There are a pletora of markown editors that have a split view w/ live preview (I used various - the one I currently have installed is Ghostwriter), but you can most probably get the same with your programmer's text editor (well, unless your text editing is done in the terminal) and, one way or another, you are not guaranteed that what you see is what will be displayed in github/gitlab/...

this post was submitted on 24 Aug 2023

11 points (73.9% liked)

Open Source

29688 readers

114 users here now

All about open source! Feel free to ask questions, and share news, and interesting stuff!

Useful Links

Rules

Posts must be relevant to the open source ideology
No NSFW content
No hate speech, bigotry, etc

Related Communities

Community icon from opensource.org, but we are not affiliated with them.

founded 5 years ago

MODERATORS

Cloak@lemmy.ml

kevincox@lemmy.ml

CrypticCoffee@lemmy.ml

Lettuceeatlettuce@lemmy.ml