bookwyrm-social/bookwyrm

Annotate text fields with supported formatting

Open

#4,088 opened on Aug 9, 2026

View on GitHubContributor guide
 (1 comment) (1 reaction) (0 assignees)Python (326 forks)auto 404
enhancementgood first issue

Repository metrics

Stars
 (2,754 stars)
PR merge metrics
 (PR metrics pending)

Description

Is your feature request related to a problem? Please describe. When making a post on Bookwyrm (a review, adding a book to my shelf, etc) I'd like to use some formatting, but I don't know what formatting is supported.

Describe the solution you'd like Add a little annotation under the text box describing what formatting is supported, like "Bookwyrm supports CommonMark" or something. (I don't know if you actually support CommonMark, but clearly some kind of markdown is supported.) If it needs a little more explanation, you could have a click to expand section or a link to a formatting page.

Describe alternatives you've considered I haven't really considered alternatives to this, because it's a standard and user friendly way to inform users of their formatting options.

Additional context None.

Contributor guide

Research direction
Look at the existing form templates for creating posts (reviews, shelf additions) and identify where to add a helper text that explains the supported formatting. Check the project's documentation or code for Markdown support to provide accurate guidance.
Tech stack
djangohtmlpython
Domain
frontend
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Git
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75