Clickable linkable headers in rails guides

[mbigras]

Hello Rails team!

One of the features I love about viewing markdown on GitHub is I'm able to easily link to headers.

On rubyonrails.org you're able to link to headers also. For example, this a link a section about dealing with basic forms.

However, it's only possible to link to these sections by scrolling up to the right bar and clicking on the relevant section; you can't just click on the header link when viewing a markdown file on GitHub.

Reading through the documentation contribution section and it looks markdown is used for the guides.

• Does the clickable functionality come from the type of renderer used?
• What does rubyonrails.org use to render markdown?
• What should I start learning/reading/doing if I'd like to eventually have clickable headers for the rails guides?

I looked through the documentation contributing guidelines but nothing jumped out at me immediately.

[maclover7]

cc @fxn

[cefigueiredo]

Rails guides uses Redcarpet Markdown

[mbigras]

@cefigueiredo thank you for the jumpstart!

Will look through vmg/redcarpet and see if I can find anything helpful 👍