[Feature request:] adding MultiMarkDown File Transclusion or AsciiDoc include to GitHub.com

Dear GitHub developers,

I didn’t know where to post this feature request (irinically!) and saw others posting here, so am I :slight_smile:

Basically I want to have my literal programed documentation with colapisble parts modularazed and rendred properly on GitHub. I could get the collapsible part working as I have explained here, but the inclusion doesn’t work. I was wondering if the MultiMarkDown File Transclusion and AsciiDoc Include, could be added to the GitHub.com service. reStructuredText also has include, but not sure if it is renderd on github as well, nice to consider also.

Thanks for your support in advance and looking forwards to have this feature.

Hi @foadsf,

Thanks for this feedback! We’re always working to improve GitHub and the GitHub Community Forum, and we consider every suggestion we receive. I’ve logged your feature request in our internal feature request list.

Though I can’t guarantee anything or share a timeline for this, I can tell you that it’s been shared with the appropriate teams for consideration.

Please let me know if you have any other questions.

Cheers!

1 Like

Dear @andreagriffiths11 ,

Thanks for considering my request and also thanks to the GitHub Support team at Twitter who opened the reply option (see this tweet).

Lightwight markap languages such as diffrent falvour of MarkDown, AsciiDoc … can be very usefull for documentation of the projects.right now most of github sections have the option to preview the final result. Instead there could be options to see the code in MarkDown, AsciiDoc,… or even WYSIWYG like here. This could be done using projects like Pandoc to convert these different formats on the go.

Another feature which would be great to consider is the syntax highlighting. Although right now syntax highliting works by default for many languages, it does not include all of the highlighjs supported ones. For example the language I’m using at this moment, Scilab, is supported originally by highlightjs, but not by GitHub. I would appreciate if you could also consider this.

Hi @foadsf,

Thanks for reaching out! We use open source TextMate-style language grammars for syntax highlighting, which are available here:

https://github.com/github/linguist/blob/master/grammars.yml

The fastest way to get this fixed would be to open an issue or contribute a fix for your specific grammar concern in the repository.

Linguist pulls in grammar updates with each new release, which usually happens every couple of weeks. This should get fixed on GitHub.com shortly after that happens.

I hope this helps!

1 Like

Hi @andreagriffiths11 again,

The language i’m looking for, Scilab, is right there at the buttom of the list:

firefox_2019-03-20_14-38-17.png

strange that the syntax highlighting stil not working!