jekyll-build-pages
jekyll-build-pages copied to clipboard
markdown: GFM does not include permalink contents
Docs say:
only our GFM processor will always match the results you see on GitHub
https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll
I have a pages site configured with markdown: GFM
but the way github renders my README.md is different than the jekyll generated page.
I reference a repository permalink in the markdown and github renders this inline in the page:
The jekyll generated site does not, it just renders the URL:
See https://github.com/rectalogic/pagetest
There are differences between current GFM and features being available (only) on dotcom, think callouts, diagrams, different behavior of links, ToCs etc.
(The feature of expanding code permalink previews only works in the same repo — you won't get it across different repos, in wikis etc., so that's also not universally available.)
This seems more like a docs bug than anything. I can't seem to be able to find the quote you referred @rectalogic, could you point me to the exact location this is stated (as it's not correct and would need fixing)? Thanks!
The quote is on this page https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/setting-a-markdown-processor-for-your-github-pages-site-using-jekyll
D'oh! Thanks — I'll get it fixed, and also added to the list of pages that need a product callout reminding the differences.
You can close this issue, it really needs fixing in https://github.com/github/docs/issues/34334 instead.