<!--IssueSummary start--> <details> <summary> Everyone can contribute. [Help move this issue forward](https://handbook.gitlab.com/handbook/marketing/developer-relations/contributor-success/community-contributors-workflows/#contributor-links) while earning points, leveling up and collecting rewards. </summary> - [Close this issue](https://contributors.gitlab.com/manage-issue?action=close&projectId=278964&issueIid=32207) </details> <!--IssueSummary end--> ### Problem to solve Syntax highlighting in markdown READMEs is indispensible. We should support this in org-mode too. ### Intended users * [Sasha (Software Developer)](https://about.gitlab.com/handbook/marketing/product-marketing/roles-personas/#sasha-software-developer) * [Dana (Data Analyst)](https://about.gitlab.com/handbook/marketing/product-marketing/roles-personas/#dana-data-analyst) * [Delaney (Development Team Lead)](https://about.gitlab.com/handbook/marketing/product-marketing/roles-personas/#delaney-development-team-lead) ### Further details Org-mode is a very popular format in the FOSS world, and is arguably more powerful than markdown. Unlike markdown, it has a single, cohesive implementation that should be easy to adapt to. ### Proposal Extract the language from `#+begin_src` blocks, and use the [rouge](https://rubygems.org/gems/rouge) ruby gem to highlight the code. ### Documentation A url to org-mode docs should be enough, since org-mode is extensively documented. Or a side-note saying that `#+begin_src <lang>` blocks work the same as ``` blocks in markdown.