[New Feature] Support for Footnotes!

post by Ruby · 2022-01-04T07:35:21.500Z · LW · GW · 31 comments

Contents

  Footnotes will automatically renumber as you add and delete them!
None
31 comments

It is with great excitement[1] that I am pleased to announce that the main LessWrong text editor[2] now has support for footnotes![3] A huge thanks to our friends over at the Effective Altruism Forum who coded this one up.

You can insert footnotes via:

1. Manually selecting text in the text box and selecting insert footnote from the footnotes menu icon.

The footnote icon is the [*] on the right.

2. Using Markdown syntax

Footnotes will automatically renumber as you add and delete them!

What's more, footnotes will render with hover-over previews once published:

Behold! A footnote hover-preview!

That's it. Go forth and create scholarly works!

  1. ^

    I mean it, really. I've looked forward to us adding this support for years.

  2. ^

    That is, the LW Docs editor, as distinct from the Markdown editor and legacy Draft-JS editor.[4]

  3. ^

    The Markdown editor already had support for footnotes using Markdown footnote syntax.

  4. ^

    Yes, footnotes can have footnotes. And those footnotes can reference themselves.[4]

31 comments

Comments sorted by top scores.

comment by TurnTrout · 2022-01-04T07:37:18.431Z · LW(p) · GW(p)

Thank you! I've looked forward to this for a long time. 

I don't see how to add footnotes in comments via the LW Docs editor, is that not supported?

Replies from: Ruby
comment by Ruby · 2022-01-04T07:39:23.455Z · LW(p) · GW(p)

Seems not, though I think it should be. I'll get back to you.

comment by adamShimi · 2022-01-05T10:10:39.087Z · LW(p) · GW(p)

It would be a slight exaggeration to say that this is the best day of my life. Only a slight one though. Thanks for the great work!

Replies from: Ruby
comment by Ruby · 2022-01-06T00:53:17.905Z · LW(p) · GW(p)

<3

comment by Chris_Leong · 2022-01-04T10:58:30.886Z · LW(p) · GW(p)

Awesome, I really think this feature will improve the quality of discussion here as it makes it much easier to note any caveats without having to break the flow of your writing. And I've always been too lazy to switch to markdown just to get footnotes working.

comment by Maxwell Peterson (maxwell-peterson) · 2022-01-08T19:02:32.598Z · LW(p) · GW(p)

These are great - I’m writing a very long citation-heavy post right now and this feature arrived just in time! And the automatic renumbering already probably saved me an hour.

Having added them, though, they feel a bit big and heavy. I find my eye catching on them as I read, and my internal reading voice pausing when I arrive at them. My current solution is relegating the location of each footnote marker to the end of the sentence, which avoids the hitching but can be confusing: am I saying the whole sentence has a citation, or just the link in the sentence?

I’m currently reading this year’s physical essay collection, and they use a footnote style without brackets, and located at the bottom corner of the text instead of top corner (subscript instead of superscript). My eyes find this style less disruptive - the lack of brackets is probably the biggest part of that, with the sub-instead-of-super a smaller part. I would prefer this style on the site as well. Thought I’d mention it as something to consider - though it could be just a me thing. Either way they are great and thank you!!

Replies from: Ruby
comment by Ruby · 2022-01-16T22:46:51.490Z · LW(p) · GW(p)

My concern is that without the brackets, they're even smaller and harder to see and click.

Replies from: maxwell-peterson
comment by Maxwell Peterson (maxwell-peterson) · 2022-01-16T23:58:49.511Z · LW(p) · GW(p)

That’s reasonable! I did nearly miss the first one from the physical book. Since my piece used them just to help readers years from now, when some of the URLs I linked to inevitably break, I wouldn’t mind readers missing them, but I get that that’s far from the only use of footnotes.

comment by Yoav Ravid · 2022-01-16T20:42:51.842Z · LW(p) · GW(p)

This post [LW · GW] had a long footnote (#3) and I tried to middle click the footnote to scroll down, which made the hover preview disappear. I think it would be nice if it didn't.

comment by naman (namankamra) · 2022-01-05T10:49:30.445Z · LW(p) · GW(p)

Thanks for doing this! I just learned that the EA forum uses the same framework under the hood as LW, is it open source? if yes, how can I spin up my own version of this?

Replies from: Ruby
comment by basil.halperin (bhalperin) · 2022-01-04T14:16:31.722Z · LW(p) · GW(p)

This is excellent, thank you! I don't know of a solution to this problem, but FWIW it seems that webclippers somewhat break on these -- e.g. (1) Instapaper doesn't show the footnote number in the body of the text, only the footnote text at the end of the post; (2) Pocket shows the footnote number in the body of the text, but no where shows the footnote text itself.

Thanks again!

comment by benjaminikuta · 2022-01-04T09:08:24.604Z · LW(p) · GW(p)

Nested footnotes reminds me of an xkcd comic. 

https://xkcd.com/1208/

Replies from: Gunnar_Zarncke
comment by Gunnar_Zarncke · 2022-01-04T10:00:15.912Z · LW(p) · GW(p)

I first saw the nested footnote in Expert C Programming

comment by Yoav Ravid · 2022-01-04T19:34:42.789Z · LW(p) · GW(p)

Awesome! I'd be happy to see old posts with footnotes edited to use the new format, either by the authors themselves or by admins.

Replies from: Yoav Ravid
comment by Yoav Ravid · 2022-01-04T19:41:31.064Z · LW(p) · GW(p)

Migrated one of my posts to use the new system. Very nice. Two more things I noticed:

  1. When there's a link to another post in a footnote it shows in the footnote hover preview, but when you hover over the link to the post there's no hover preview for the post.
  2. When I click the arrow to go back to the article from the footnotes it takes me up, then unhides the top bar which covers the footnote. My suggestion is either to make it take you a little higher so the top bar doesn't cover it, or make it not unhide the top bar.
comment by Pattern · 2022-01-04T18:45:34.797Z · LW(p) · GW(p)

Is this for posts, comments or both? ^1 

  1. ^ Testing in markdown editor. ^2
  2. ^ Didn't seem to work. Switched to Draft-JS. ^3
  3. Nor in LessWrong Docs [Beta].
Replies from: SaidAchmiz
comment by Said Achmiz (SaidAchmiz) · 2022-01-04T19:51:18.145Z · LW(p) · GW(p)

Works perfectly in Markdown, actually.[1]

You just have to put square brackets around your citations and your footnote definition numbers:

This would be a footnote reference.[^2]

[^2]: And here we would define the footnote.

(In fact, it’s worked in Markdown for a while before now…)


  1. See? ↩︎

Replies from: Pattern, SaidAchmiz
comment by Pattern · 2022-01-04T21:42:35.881Z · LW(p) · GW(p)

This would be a footnote [1] reference.


  1. footnote. ↩︎
  2. It still works after switching to a different editor.
  3. Both of them.
     
comment by Said Achmiz (SaidAchmiz) · 2022-01-04T19:56:01.390Z · LW(p) · GW(p)

What about nested footnotes in Markdown?[1]

Yep, they work.


  1. Like…[2] ↩︎

  2. … this! ↩︎

  3. And even self-referential ones?[3] ↩︎

Replies from: Pattern
comment by Pattern · 2022-01-04T21:43:52.794Z · LW(p) · GW(p)

Thanks.

comment by papetoast · 2023-02-03T10:01:37.369Z · LW(p) · GW(p)

It is really annoying that if you use footnotes from the LW Docs Editor, and then switches to the Markdown editor, the footnotes get irrevertably messed up like this[[1]](#fnhqkg4lye79s)

  1. **[^](#fnrefhqkg4lye79s)**

    this is an example footnote

comment by ukc10014 · 2022-10-06T18:00:59.713Z · LW(p) · GW(p)

I noticed that footnotes don't seem to come over when I copy-paste from Google Docs (where I originally wrote the post), hence I have to put them in individually (using the LW Docs editor). Is there a way of just importing them? Or is the best workflow to just write the post in LW Docs?

comment by isle9 · 2022-08-17T13:39:44.361Z · LW(p) · GW(p)

What about adding support for something like this (footnotes and just notes? on the sides)?

I never realized how much wasted space there is.

Replies from: Ruby
comment by Ruby · 2022-08-17T18:31:14.256Z · LW(p) · GW(p)

It's one of the things we want to experiment with!

Replies from: bendini, isle9
comment by Bendini (bendini) · 2023-07-23T11:16:43.492Z · LW(p) · GW(p)

Is this feature likely to be released in the near future?

I personally have a post sitting in drafts that is far too long to rely on footnotes, as it would break the reading experience. Sidenotes would be ideal for these kinds of posts, but it would be almost as good if you had an option to put them at the end of a paragraph in a little box or something, as that would translate well to the mobile reading experience. 

comment by isle9 · 2022-08-17T19:10:31.425Z · LW(p) · GW(p)

I'm glad to hear that! I only just now realized that footnotes were also quite recently implemented. 

comment by Oliver Sourbut · 2022-05-09T02:39:46.026Z · LW(p) · GW(p)

Can I write a[1]

(Yes, but I have to indent the subsequent lines by four spaces)


  1. Multi-line

    footnote? ↩︎

comment by David Gross (David_Gross) · 2022-01-06T23:54:38.210Z · LW(p) · GW(p)

Thanks for the new feature. Minor bug report here: The footnote marker seems to be followed by a non-breaking space, such that it can interfere with normal paragraph formatting. See the bullet point that begins "correlates suggestively with virtues like altruism" on this page [? · GW].

comment by Erich_Grunewald · 2022-01-04T11:25:56.163Z · LW(p) · GW(p)

This is excellent, thanks!

I see a minor bug with the hover view, e.g. in the second footnote of this post [LW · GW] -- perhaps it has something to do with the whole footnote content being a hyperlink?

Replies from: Ruby
comment by Ruby · 2022-01-04T11:40:23.542Z · LW(p) · GW(p)

Interesting! Sorry about that bug, we'll look into it.