Skip to content

multi-line footnotes don't render in HTML version #840

@jtbayly

Description

@jtbayly

I ran into this issue with @cderv over on the Rstudio community site, and he suggested that I should open an issue here.

If you try to use a pandoc-style multi-line footnote (as shown below) it will not be rendered in the HTML version of the book, and following footnotes in the same chapter will be mis-numbered. (It will render correctly in the PDF and ePub file, though.)

If you add an empty page at the end of your book for citations, then the footnote will incorrectly show up there (unless there are additional footnotes after it in the same chapter, in which case it won't show up anywhere, even in the references/citations page).

Sample footnote (number 1) that will not show up anywhere, even if you include a references/citations section:

Here is some text with a footnote[^1] specified.

Here's another paragraph[^2] with a second footnote[^3].


[^1]: This is my multi-paragraph footnote first paragraph.

    This is a continuation of the footnote.

[^2]: Second footnote text.

[^3]: Third footnote. 

I'm running the latest code and I've done my best to provide all the necessary information, including reproducible code. But I don't know what an "xfun::session_info('bookdown')" is. Nor have I tested this on the development version. Perhaps @cderv can help me out with those?


By filing an issue to this repo, I promise that

  • I have fully read the issue guide at https://yihui.org/issue/.
  • I have provided the necessary information about my issue.
    • If I'm asking a question, I have already asked it on Stack Overflow or RStudio Community, waited for at least 24 hours, and included a link to my question there.
    • If I'm filing a bug report, I have included a minimal, self-contained, and reproducible example, and have also included xfun::session_info('bookdown'). I have upgraded all my packages to their latest versions (e.g., R, RStudio, and R packages), and also tried the development version: remotes::install_github('rstudio/bookdown').
    • If I have posted the same issue elsewhere, I have also mentioned it in this issue.
  • I have learned the Github Markdown syntax, and formatted my issue correctly.

I understand that my issue may be closed if I don't fulfill my promises.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugan unexpected problem or unintended behavior

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions