Automattic / Automattic/jetpack

Markdown block: Parsing issues and inconsistencies

Open
#11,881 10 comments 4 reactions 0 assignees View on GitHub
[Feature] Markdown [Focus] Blocks [Pri] Low Bug Epic Good For Community Hacktoberfest
Dominant language
PHP
Stars
1.8k
Forks
898
Avg merge
1d 18h
Merged PRs (30d)
774

Description

In testing how elements are recognized and parsed in our Jetpack Markdown block for Gutenberg, we've discovered several issues and inconsistencies so far.

This is a master issue for all of them, feel free to add any others that you find.

* [x] Footnotes / reference links differences -- #30149
* Reported by @mapk in https://github.com/Automattic/jetpack/pull/10133#issuecomment-421158443
* Reported by @jeherve in p1HpG7-5EW-p2 #comment-27928
* [ ] Images with alts and titles not supported
* Reported by @jeherve in p1HpG7-5EW-p2 #comment-27928
* [ ] Single empty lines are omitted
* Reported by @Stojdza in p1HpG7-5EW-p2 #comment-27911
* Reported by @carladoria in p58i-7sR-p2 #comment-40539
* Reported by @reginabally in p58i-7sR-p2 #comment-40610
* [ ] Alternative heading syntax parsed incorrectly on iPad Pro
* Reported by @eliorivero in p1HpG7-5EW-p2 #comment-27968
* [ ] Code block not properly styled
* Reported by @carladoria in p58i-7sR-p2 #comment-40539

Contributor guide

Open the contributing guide

Research direction

Start with the Jetpack Markdown block in Gutenberg and review each unchecked parsing or rendering case listed in this master issue. Treat the work as complete only when the affected cases—image alt/title handling, empty lines, alternative headings, and code-block styling—are addressed and verified.

Written by the indexing model from the issue text.

Assessment

Tech stack
php, wordpress
Domain
content
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.