A markdown reader with several markdown-it plugins

Is jzheaux/reader beginner-friendly?

In the last 30 days, jzheaux/reader merged 9 of 12 pull requests from outside contributors, and its maintainers usually reply within 1 day. 2 beginner-friendly issues are open now.

Stars
0
Forks
1
Open beginner issues
2
Indexed issues
189
Avg merge
2d 4h
Merged PRs (30d)
26
Dominant language
JavaScript
License
MIT
Last GitHub push
Oct 24, 2026
Latest indexed
Oct 25, 2026
Contributing guide
Contributing guide
Code of conduct
No code of conduct
Beginner labels
good first issue

How to contribute to jzheaux/reader

  1. Read the contributing guide first: it says how the maintainers want changes proposed, tested and reviewed.
  2. It ships a Dockerfile or Docker Compose file, so you can run it without installing its whole toolchain.
  3. Your contributions will be published under the project's MIT license.
  4. Pick one of the 2 open beginner-friendly issues below and comment that you want to work on it before you start.

Issues somebody may already be working on are listed last. List everything by date

  • Let other packages render and export with reader through a public API
    Open
    polish

    Difficulty 2/5 1-3 hours Newbie friendliness 74/100

    jzheaux/reader#318 ·

    Maintainers usually reply within 1 day

  • Export a page with its source and where its asides are sent
    Open
    enhancement

    Difficulty 3/5 1-2 days Newbie friendliness 55/100

    jzheaux/reader#317 ·

    Maintainers usually reply within 1 day

  • Find the line a click is on, for each line of a paragraph
    Open
    enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 35/100

    jzheaux/reader#316 ·

    Maintainers usually reply within 1 day

  • Write an aside into a document from code, as the parser reads it
    Open
    polish

    Difficulty 3/5 1-2 days Newbie friendliness 64/100

    jzheaux/reader#315 ·

    Maintainers usually reply within 1 day

  • Name a list of choices under a question by the question
    Open
    accessibility

    Difficulty 3/5 1-2 days Newbie friendliness 60/100

    jzheaux/reader#313 ·

    Maintainers usually reply within 1 day

  • Test what each browser-check step does in a browser
    Open
    good first issue infrastructure

    Difficulty 4/5 3-5 days Newbie friendliness 57/100

    jzheaux/reader#311 ·

    Maintainers usually reply within 1 day

  • Draw a tune's notes at a size that reads easily, wrapping its bars and using the margin beside it
    Open

    Difficulty 4/5 3-5 days Newbie friendliness 48/100

    jzheaux/reader#306 ·

    Maintainers usually reply within 1 day

  • Add front matter support for turning specific features on or off
    Open

    Difficulty 4/5 3-5 days Newbie friendliness 48/100

    jzheaux/reader#304 ·

    Maintainers usually reply within 1 day

  • Name a block with an anchor of its own
    Open

    Difficulty 5/5 Over a week Newbie friendliness 35/100

    jzheaux/reader#299 ·

    Maintainers usually reply within 1 day

  • A checkbox should be named by everything drawn beside it
    Open
    accessibility bug

    Difficulty 4/5 3-5 days Newbie friendliness 42/100

    jzheaux/reader#298 ·

    Maintainers usually reply within 1 day

  • Order features by what each one reads
    Open
    polish

    Difficulty 4/5 3-5 days Newbie friendliness 35/100

    jzheaux/reader#296 ·

    Maintainers usually reply within 1 day

  • A task's box should be named with a date written in its line
    Open
    accessibility bug good first issue

    Difficulty 2/5 1-3 hours Newbie friendliness 85/100

    jzheaux/reader#268 ·

    Maintainers usually reply within 1 day

  • Keep a file's actions with the file, and the top bar for the view
    Open
    enhancement layout

    Difficulty 4/5 3-5 days Newbie friendliness 48/100

    jzheaux/reader#260 ·

    Maintainers usually reply within 1 day

  • Explore making the next day's file with a script or an agent
    Open
    enhancement P3

    Difficulty 5/5 Over a week Newbie friendliness 20/100

    jzheaux/reader#259 ·

    Maintainers usually reply within 1 day

  • Carry a to-do list's unticked items into today's
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 35/100

    jzheaux/reader#258 ·

    Maintainers usually reply within 1 day

  • Go to the next or previous page not yet done, in a workbook
    Open
    enhancement

    Difficulty 3/5 1-2 days Newbie friendliness 63/100

    jzheaux/reader#257 ·

    Maintainers usually reply within 1 day

  • Show how many threads are open in each file of the file list
    Open
    enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 55/100

    jzheaux/reader#255 ·

    Maintainers usually reply within 1 day

  • Play puzzles on a phone
    Open
    behavior enhancement

    Difficulty 5/5 Over a week Newbie friendliness 38/100

    jzheaux/reader#246 ·

    Maintainers usually reply within 1 day

  • Recognize recurring files by folder and tag
    Open
    behavior enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 18/100

    jzheaux/reader#239 ·

    Maintainers usually reply within 1 day

  • Save searches as favorites in the top bar
    Open
    behavior enhancement

    Difficulty 5/5 Over a week Newbie friendliness 18/100

    jzheaux/reader#238 ·

    Maintainers usually reply within 1 day

  • A Number Field Could Be Picked From a Range
    Open
    enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 30/100

    jzheaux/reader#223 ·

    Maintainers usually reply within 1 day

  • Support GitHub's Footnotes, With [^1] and a Note Under It
    Open
    enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 35/100

    jzheaux/reader#222 ·

    Maintainers usually reply within 1 day

  • A Box Could Show Which Phase an Item Is In, From Phases Named in the Front Matter
    Open
    enhancement team-attention

    Difficulty 5/5 Over a week Newbie friendliness 15/100

    jzheaux/reader#220 ·

    Maintainers usually reply within 1 day

  • Support Clean Merges of Local Changes and Filesystem Changes
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 18/100

    jzheaux/reader#218 · 1 comment ·

    Maintainers usually reply within 1 day

  • Celebrate Finishing Something, Such as Confetti When a To-Do Is Done
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 15/100

    jzheaux/reader#214 ·

    Maintainers usually reply within 1 day

  • Show Changes Made to the Files Elsewhere Without Waiting for Focus
    Open
    enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 30/100

    jzheaux/reader#207 ·

    Maintainers usually reply within 1 day

  • Show a reader file opened in a browser tab with an extension
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#205 ·

    Maintainers usually reply within 1 day

  • Show a reader file from its URL on the docs site, with no install
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 38/100

    jzheaux/reader#204 ·

    Maintainers usually reply within 1 day

  • Let a file say it's written for reader with reader: in its front matter
    Open
    enhancement team-attention

    Difficulty 3/5 1-2 days Newbie friendliness 62/100

    jzheaux/reader#203 ·

    Maintainers usually reply within 1 day

  • Render in a browser from the same renderer, with a build step
    Open
    enhancement infrastructure

    Difficulty 5/5 Over a week Newbie friendliness 38/100

    jzheaux/reader#202 ·

    Maintainers usually reply within 1 day

  • A reader-markdown file should open as reader shows it, from any site
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 35/100

    jzheaux/reader#201 ·

    Maintainers usually reply within 1 day

  • Following a link to another document should leave a way back
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 35/100

    jzheaux/reader#174 ·

    Maintainers usually reply within 1 day

  • Edits as asides: CriticMarkup under a line, by a reviewer
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#164 ·

    Maintainers usually reply within 1 day

  • Editor's markup: read CriticMarkup, drawn as an editor's pen
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 35/100

    jzheaux/reader#163 ·

    Maintainers usually reply within 1 day

  • Stand in for a page's frames with one test helper
    Open
    infrastructure

    Difficulty 3/5 1-2 days Newbie friendliness 78/100

    jzheaux/reader#162 ·

    Maintainers usually reply within 1 day

  • Give each test a clean slate of the app's state
    Open
    infrastructure

    Difficulty 4/5 3-5 days Newbie friendliness 55/100

    jzheaux/reader#161 ·

    Maintainers usually reply within 1 day

  • Badges under the title for a document's source, audio, video and PDF
    Open
    enhancement

    Difficulty 4/5 3-5 days Newbie friendliness 55/100

    jzheaux/reader#160 ·

    Maintainers usually reply within 1 day

  • Perform Release Review
    Open
    review

    Difficulty 4/5 3-5 days Newbie friendliness 52/100

    jzheaux/reader#127 ·

    Maintainers usually reply within 1 day

  • A graph fence: lines and points on graph paper
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#126 ·

    Maintainers usually reply within 1 day

  • A problems fence: math problems reader can check
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 28/100

    jzheaux/reader#125 ·

    Maintainers usually reply within 1 day

  • Have someone who needs more contrast or is colour-blind review the look, before 1.0
    Open
    accessibility

    Difficulty 4/5 3-5 days Newbie friendliness 42/100

    jzheaux/reader#120 ·

    Maintainers usually reply within 1 day

  • One way to write settings, and what each covers
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#112 ·

    Maintainers usually reply within 1 day

  • Uploading artwork
    Open
    enhancement question

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#103 ·

    Maintainers usually reply within 1 day

  • Marker characters for marks: a symbol beside the words instead of a line
    Open
    enhancement

    Difficulty 3/5 1-2 days Newbie friendliness 55/100

    jzheaux/reader#102 ·

    Maintainers usually reply within 1 day

  • Extend attribution to list items
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 45/100

    jzheaux/reader#101 ·

    Maintainers usually reply within 1 day

  • Perform Release Review
    Open
    review

    Difficulty 5/5 Over a week Newbie friendliness 20/100

    jzheaux/reader#83 ·

    Maintainers usually reply within 1 day

  • Perform Release Review
    Open
    review

    Difficulty 5/5 Over a week Newbie friendliness 20/100

    jzheaux/reader#82 ·

    Maintainers usually reply within 1 day

  • include: bring in a passage, code or a template from another file
    Open
    enhancement

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#71 ·

    Maintainers usually reply within 1 day

  • Review copy: send the review back to reader with a POST
    Open
    enhancement P3

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#69 ·

    Maintainers usually reply within 1 day

  • Review copy: an exported page that takes asides and sends back markdown
    Open
    enhancement P3

    Difficulty 5/5 Over a week Newbie friendliness 25/100

    jzheaux/reader#68 ·

    Maintainers usually reply within 1 day

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.