Skip to content

fix(rn-publish): convert markdown description to HTML via pandoc#39

Open
leanderdruwel-skyline wants to merge 1 commit into
SkylineCommunications:mainfrom
leanderdruwel-skyline:fix/rn-publish-markdown-to-html
Open

fix(rn-publish): convert markdown description to HTML via pandoc#39
leanderdruwel-skyline wants to merge 1 commit into
SkylineCommunications:mainfrom
leanderdruwel-skyline:fix/rn-publish-markdown-to-html

Conversation

@leanderdruwel-skyline
Copy link
Copy Markdown
Collaborator

Problem

The collaboration platform uses a rich-text editor (contenteditable div) that stores and renders HTML. The workflow was sending raw GitHub Flavored Markdown text, which caused two issues:

  1. Paragraph breaks invisible - \n\n between paragraphs is treated as whitespace in HTML, so all paragraphs run together as one block of text
  2. Markdown syntax visible - *italic*, backtick code, **bold** appear as literal characters instead of being rendered

Example

The InfraOps RN had 3 paragraphs in the GitHub comment, but showed as one on collaboration.dataminer.services because the platform ignored the newline separators.

Fix

Pipe the extracted description through pandoc (pre-installed on ubuntu-latest) to convert GFM to HTML before sending to the API. This produces proper <p>, <em>, <code>, <strong>, <ul>/<li> tags that match what the platform expects.

The ::debug:: log line lets you verify the converted HTML in the Actions run output before trusting the result.

The collaboration platform uses a rich-text editor (contenteditable div)
that renders HTML. Previously, descriptions were sent as raw GitHub
Flavored Markdown text, which caused:
- Paragraph breaks (\n\n) to be invisible (all text bundles into one paragraph)
- Markdown syntax (*italic*, \code\, **bold**) to appear literally

Fix: pipe the extracted description through pandoc (pre-installed on
ubuntu-latest) to convert GFM → HTML before sending to the API. This
produces <p>, <em>, <code>, <strong>, <ul>/<li> tags that the platform
renders correctly.

Also adds a ::debug:: log line so the converted HTML is visible in the
Actions run output for validation.

Co-authored-by: Copilot <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant