2. a
. The same happened for an empty item ([foo]: /url then -), after a definition with a title, and inside a block quote.
ListBlockParser.Factory decided whether it was in a paragraph with !matchedBlockParser.getParagraphLines().isEmpty(). getParagraphLines() leaves out the lines already parsed as definitions, so for a paragraph with only definitions it was empty, and the list was allowed to interrupt it. But that paragraph is still open, and the next line is paragraph continuation text, as spec example 217 shows for === after a definition (it stays in the paragraph instead of becoming a setext heading). The check now looks at whether the matched block is a Paragraph, as HtmlBlockParser already does for type 7.
commonmark.js 0.31.2 renders all the new test cases the same way.
SpecialInputTest#listCanNotInterruptParagraphWithOnlyLinkReferenceDefinitions fails without the change. mvn install (all modules) and mvn spotless:check (JDK 17) pass.
For context, this came up when comparing the HTML output of commonmark-java with commonmark.js 0.31.2 on 150,000 generated inputs. With the change, the two inputs whose output changed now match commonmark.js, and no other output changed.
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:c51f62cf-5c57-d093-71af-42cb2cec9be9 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | D3A6:110FE5:2EAE32:3E197E:6AFBB86F |
| html-safe-nonce | ecd5134bde70224f74eb7d2965be5f3e63eff141680f861f1724a22f06345abe |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEM0E2OjExMEZFNToyRUFFMzI6M0UxOTdFOjZBRkJCODZGIiwidmlzaXRvcl9pZCI6IjY3ODY3Mzg2ODUzMzgxNzE1MDMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 50caf47675a95a534591e10e3890ccf94518f119b42b7344465174a7cff0baee |
| hovercard-subject-tag | pull_request:5050219462 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | ///pull_requests/show/files |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/commonmark/commonmark-java/pull/472/files |
| twitter:image | https://avatars.githubusercontent.com/u/271969568?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/271969568?s=400&v=4 |
| og:image:alt | An ordered list that doesn't start with 1, or an empty list item, can't interrupt a paragraph (spec section 5.2). This wasn't applied when the paragraph so far only had link reference d... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | 2b2ef9c1578c18d8ed27027940544c958743213cf4461659f14d3ccdf51e162c |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/commonmark/commonmark-java git https://github.com/commonmark/commonmark-java.git |
| octolytics-dimension-user_id | 8661225 |
| octolytics-dimension-user_login | commonmark |
| octolytics-dimension-repository_id | 39477878 |
| octolytics-dimension-repository_nwo | commonmark/commonmark-java |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 39477878 |
| octolytics-dimension-repository_network_root_nwo | commonmark/commonmark-java |
| turbo-body-classes | logged-out env-production page-responsive full-width |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | e4cce0e99cf61481a318ff12c2e8580153a6c7c6 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| Skip to content | https://github.com/commonmark/commonmark-java/pull/472/files#start-of-content |
| https://github.com/ |
| Sign in | https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fcommonmark%2Fcommonmark-java%2Fpull%2F472%2Ffiles |
| GitHubRepository hosting, code review, and collaboration | https://github.com/platform |
| CopilotAI coding agent for tasks, projects, and automated work | https://github.com/features/copilot |
| ActionsCI/CD and automation | https://github.com/features/actions |
| Code QualityQuality analysis, fixes, and enforcement | https://github.com/features/code-quality |
| CodespacesCloud development environments | https://github.com/features/codespaces |
| Code SecurityVulnerability detection and remediation | https://github.com/security/advanced-security/code-security |
| Secret ProtectionSecret scanning and leak prevention | https://github.com/security/advanced-security/secret-protection |
| All Features | https://github.com/features |
| Documentation | https://docs.github.com/en |
| Training | https://learn.github.com/skills |
| Certifications | https://learn.github.com/credentials |
| Build with Copilot | https://github.com/features/ai |
| Customize Copilot | https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview |
| Integrations | https://github.com/marketplace |
| Trending repos | https://github.com/trending |
| GitHub Sponsors | https://github.com/open-source/sponsors |
| Developer articles | https://github.com/resources/articles |
| ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place. | https://github.blog/changelog/ |
| Enterprises | https://github.com/enterprise |
| Team | https://github.com/team |
| Startups | https://github.com/enterprise/startups |
| Nonprofits | https://github.com/solutions/industry/nonprofits |
| Healthcare | https://github.com/solutions/industry/healthcare |
| Financial services | https://github.com/solutions/industry/financial-services |
| Manufacturing | https://github.com/solutions/industry/manufacturing |
| Government | https://github.com/solutions/industry/government |
| See all industries | https://github.com/solutions/industry |
| Why GitHub | https://github.com/why-github |
| Customer Stories | https://github.com/customer-stories |
| Business insights | https://github.com/solutions/executive-insights |
| Trust Center | https://github.com/trust-center |
| GitHub Advanced SecurityEnterprise-grade code security | https://github.com/security/advanced-security |
| Copilot for businessEnterprise-grade AI features | https://github.com/features/copilot/copilot-business |
| Premium SupportEnterprise-grade 24/7 support | https://github.com/enterprise/premium-support |
| Documentation | https://docs.github.com/en |
| Resource center | https://github.com/resources |
| Blog | https://github.blog/ |
| Events & webinars | https://github.com/resources/events |
| Community Forum | https://github.com/orgs/community/discussions |
| Customer Stories | https://github.com/customer-stories |
| Integrations | https://github.com/marketplace |
| Customer support | https://help.github.com/ |
| Training | https://learn.github.com/skills |
| GitHub Status | https://www.githubstatus.com/ |
| About | https://github.com/about |
| Partners | https://github.com/partners |
| Changelog | https://github.blog/changelog/ |
| GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub. | https://githubuniverse.com/ |
| Pricing | https://github.com/pricing |
| Sign in | https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fcommonmark%2Fcommonmark-java%2Fpull%2F472%2Ffiles |
| Sign up | https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=commonmark%2Fcommonmark-java |
| Reload | https://github.com/commonmark/commonmark-java/pull/472/files |
| Reload | https://github.com/commonmark/commonmark-java/pull/472/files |
| Reload | https://github.com/commonmark/commonmark-java/pull/472/files |
| commonmark | https://github.com/commonmark |
| commonmark-java | https://github.com/commonmark/commonmark-java |
| Code | https://github.com/commonmark/commonmark-java |
| Issues9 (9) | https://github.com/commonmark/commonmark-java/issues |
| Pull requests4 (4) | https://github.com/commonmark/commonmark-java/pulls |
| Actions | https://github.com/commonmark/commonmark-java/actions |
| Wiki | https://github.com/commonmark/commonmark-java/wiki |
| Security and quality8 (8) | https://github.com/commonmark/commonmark-java/security |
| Insights | https://github.com/commonmark/commonmark-java/pulse |
| Sign up for GitHub
| https://github.com/signup?return_to=%2Fcommonmark%2Fcommonmark-java%2Fissues%2Fnew%2Fchoose |
| terms of service | https://docs.github.com/terms |
| privacy statement | https://docs.github.com/privacy |
| Sign in | https://github.com/login?return_to=%2Fcommonmark%2Fcommonmark-java%2Fissues%2Fnew%2Fchoose |
| robinst | https://github.com/robinst |
| commonmark:main | https://github.com/commonmark/commonmark-java/tree/main |
| ybai08:fix-list-interrupt-definition-paragraph | https://github.com/ybai08/commonmark-java/tree/fix-list-interrupt-definition-paragraph |
|
Conversation
1
| https://github.com/commonmark/commonmark-java/pull/472 |
|
Commits
1
| https://github.com/commonmark/commonmark-java/pull/472/commits |
|
Checks
5
| https://github.com/commonmark/commonmark-java/pull/472/checks |
|
Files changed
2
| https://github.com/commonmark/commonmark-java/pull/472/files |
|
Don't let lists interrupt a paragraph with only link reference definitions
| https://github.com/commonmark/commonmark-java/pull/472/files#top |
|
Show all changes
1 commit
| https://github.com/commonmark/commonmark-java/pull/472/files |
|
d93fbf2
Don't let lists interrupt a paragraph with only link reference defini…
ybai08 Oct 28, 2026
| https://github.com/commonmark/commonmark-java/pull/472/commits/d93fbf23934d091ab75d1346f003b8db47206cfb |
|
Clear filters
| https://github.com/commonmark/commonmark-java/pull/472/files |
| Please reload this page | https://github.com/commonmark/commonmark-java/pull/472/files |
| Please reload this page | https://github.com/commonmark/commonmark-java/pull/472/files |
|
ListBlockParser.java
| https://github.com/commonmark/commonmark-java/pull/472/files#diff-16225e8d20078094834f700374517089857e65f8129bd8c038263571520ba1b2 |
|
SpecialInputTest.java
| https://github.com/commonmark/commonmark-java/pull/472/files#diff-4a1de84f536f459e0b9249dda82d0152bf5867004b7b3edb33130aa6f3baf714 |
| commonmark/src/main/java/org/commonmark/internal/ListBlockParser.java | https://github.com/commonmark/commonmark-java/pull/472/files#diff-16225e8d20078094834f700374517089857e65f8129bd8c038263571520ba1b2 |
|
View file
| https://github.com/ybai08/commonmark-java/blob/d93fbf23934d091ab75d1346f003b8db47206cfb/commonmark/src/main/java/org/commonmark/internal/ListBlockParser.java |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/commonmark/commonmark-java/pull/472/{{ revealButtonHref }} |
|
| https://github.com/commonmark/commonmark-java/pull/472/files#diff-16225e8d20078094834f700374517089857e65f8129bd8c038263571520ba1b2 |
|
| https://github.com/commonmark/commonmark-java/pull/472/files#diff-16225e8d20078094834f700374517089857e65f8129bd8c038263571520ba1b2 |
| commonmark/src/test/java/org/commonmark/test/SpecialInputTest.java | https://github.com/commonmark/commonmark-java/pull/472/files#diff-4a1de84f536f459e0b9249dda82d0152bf5867004b7b3edb33130aa6f3baf714 |
|
View file
| https://github.com/ybai08/commonmark-java/blob/d93fbf23934d091ab75d1346f003b8db47206cfb/commonmark/src/test/java/org/commonmark/test/SpecialInputTest.java |
|
Open in desktop
| https://desktop.github.com |
| https://github.co/hiddenchars |
| https://github.com/commonmark/commonmark-java/pull/472/{{ revealButtonHref }} |
|
| https://github.com/commonmark/commonmark-java/pull/472/files#diff-4a1de84f536f459e0b9249dda82d0152bf5867004b7b3edb33130aa6f3baf714 |
|
| https://github.com/commonmark/commonmark-java/pull/472/files#diff-4a1de84f536f459e0b9249dda82d0152bf5867004b7b3edb33130aa6f3baf714 |
| Please reload this page | https://github.com/commonmark/commonmark-java/pull/472/files |
|
| https://github.com |
| Terms | https://docs.github.com/site-policy/github-terms/github-terms-of-service |
| Privacy | https://docs.github.com/site-policy/privacy-policies/github-privacy-statement |
| Security | https://github.com/security |
| Status | https://www.githubstatus.com/ |
| Community | https://github.community/ |
| Docs | https://docs.github.com/ |
| Contact | https://support.github.com?tags=dotcom-footer |