github / markup

Determines which markup library to use to render a content file (e.g. README) on GitHub
MIT License
5.81k stars 3.41k forks source link

Multiple programming languages organized in tabs #1116

Open PoslavskySV opened 6 years ago

PoslavskySV commented 6 years ago

I have a library which supports two programming languages (say Java and Scala). Is there any way to organize this in tabbed view with markup? Like here:

example
thecatalinstan commented 6 years ago

Would love to see this one in.

alexellis commented 6 years ago

This would help 💯 with tutorials. What is the best way to do this despite the lack of functionality for it in GitHub?

PoslavskySV commented 6 years ago

@alexellis Unfortunately, I didn't find any beautiful workaround with current GitHub facilities. So, I keep the main documentation of my project on ReadTheDocs where I use sphinx-tabs plugin to organize code in tabbed view.

matchavez commented 5 years ago

Would love to see a simple implementation of this by markdown that looks like:

[tab1][tab2][tab3] Content_of_tab1Content_of_tab1Content_of_tab1Content_of_tab1 [tab1] Content_of_tab2Content_of_tab2Content_of_tab2Content_of_tab2 [tab2] Content_of_tab3Content_of_tab3Content_of_tab3Content_of_tab3 [tab3]

kroggen commented 3 years ago

Or maybe using the markdown-fenced-code-tabs extension, or its syntax

matchavez commented 3 years ago

Would be nice, but it needs to be implemented as a standard. Microsoft has already started backing away from GFM, and they're embracing CommonMark. Personally, I'd like to see some sort of SuperMarkdown that does everything that's in Material for MKDocs as an adopted superset, and changing double underscores from em to underline and single asterisks to no action.

idwise-team commented 2 years ago

This would be amazing!!

matchavez commented 2 years ago

Already exists. https://squidfunk.github.io/mkdocs-material/reference/content-tabs/#grouping-code-blocks

Like I was saying before… it's just a matter of implementing /reference of M4MKD and changing double-underscore to underline and single * to nothing.

RokeJulianLockhart commented 1 month ago

https://github.com/github/markup/issues/1116#issue-263697466

@PoslavskySV, this may be a duplicate of https://github.com/github/markup/issues/1552#issue-1249927957.