docsifyjs / docsifyjs/docsify

Please support markdown footnotes [^1] [^note]

Aperta
#1,628 6 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
JavaScript
Stelle
31.5k
Fork
5.8k
Merge medio
9g 8h
PR unite (30g)
2

Descrizione

## Feature request

#### What problem does this feature solve?

To cite the [Markdown Guide](https://www.markdownguide.org/extended-syntax/#footnotes):

> Footnotes allow you to add notes and references without cluttering the body of the document.

For instance, in docsified software manuals this would help with structuring the information given better: useful background information can be given and clearly linked with the main text, yet without making the main text too full of details.

#### What does the proposed API look like?

According to the [Markdown Guide](https://www.markdownguide.org/extended-syntax/#footnotes):

```md
A footnote[^1]

[^1] This is a footnote.
```

#### How should this be implemented in your opinion?

I'm not sure I understand this question in the context of this particular feature request.

One thing I notice it that docify authors might want to have control over the placement of footnotes: either at the end of a "page" or, alternatively, before the next same-level heading.

#### Are you willing to work on this yourself?

Unfortunately, I completely lack the necessary Javascript and markdown parsing experience to code this.

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.