github / markup

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

Footnotes don't work in Wiki #1707

Open mwisnicki opened 1 year ago

mwisnicki commented 1 year ago

I copied the example from https://docs.github.com/en/enterprise-cloud@latest/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#footnotes to wiki page but it does not render.

However it does work in issues as below.


Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].

[^1]: My reference. [^2]: To add line breaks within a footnote, prefix new lines with 2 spaces. This is a second line.

binkley commented 2 months ago

This is a long-standing problem with using GH-flavored Markdown in wikis. Is there a possible future fix to bring wiki Markdown in line for features with something like README.md?

https://docs.github.com/en/enterprise-cloud@latest/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#footnotes: image

My context: I'm working on an open source programming book using GitHub wiki pages for chapters, and would like to provide footnotes. A published version of the book would have footnotes, and I'd like the wiki pages readable by anyone to reflect this.

github-actions[bot] commented 1 week ago

Stale issue message

binkley commented 1 week ago

@mwisnicki Have you heard any progress from GitHub on this outside this issue?

mwisnicki commented 1 week ago

No