Skip to content

Add footnotes for technical writing #32

Description

@RaioViajante

Goal

Clean footnote support for articles where small tangents or references would otherwise interrupt the main text.

Approach

Prefer Markdown/remark-native footnotes (e.g. remark-footnotes or GFM-style [^1] syntax) if compatible with the current pipeline (remark-gfm, remark-frontmatter, rehype-slug, rehype-pretty-code).

Requirements

  • accessible backlinks (footnote → reference and back)
  • restrained typography — small, quiet, consistent with existing prose styles
  • no tooltip/popover system
  • no client-side JavaScript
  • preserves normal Markdown authoring — no bespoke MDX component required to write one

Do not implement until

An actual article needs footnotes. Speculative infrastructure for a need that hasn't appeared yet.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions