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

  • Type [^n] where is the number of the footnote you wish to insert.
  • To insert a new footnote, use n that is <number of existing footnotes + 1>; to reuse an existing footnote, set n to be whichever footnote you are reusing.

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]

New Comment
31 comments, sorted by Click to highlight new comments since: Today at 5:16 PM

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?

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

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!

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.

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!!

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

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.

This post 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.

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?

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!

Nested footnotes reminds me of an xkcd comic. 

https://xkcd.com/1208/

I first saw the nested footnote in Expert C Programming

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.

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.

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].

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? ↩︎

This would be a footnote [1] reference.


  1. footnote. ↩︎
  2. It still works after switching to a different editor.
  3. Both of them.
     

What about nested footnotes in Markdown?[1]

Yep, they work.


  1. Like…[2] ↩︎

  2. … this! ↩︎

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

Thanks.

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

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?

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

I never realized how much wasted space there is.

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

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. 

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

Can I write a[1]

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


  1. Multi-line

    footnote? ↩︎

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.

This is excellent, thanks!

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

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