Skip to content
This repository was archived by the owner on Mar 13, 2025. It is now read-only.

docs: render markdown links correctly inside <details> blocks #66

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

Basit-Balogun10
Copy link

@Basit-Balogun10 Basit-Balogun10 commented Mar 10, 2025

Closes: #65

Markdown links inside <details> were not rendering correctly because there was no newline after <summary>. While adding a newline could fix this, it's fragile since it can be easily refactored out by mistake.

Fix

Replaced the Markdown-style link:

[using dbt's `tags`](https://docs.getdbt.com/reference/resource-configs/tags)

with an HTML <a> tag:

<a href="https://docs.getdbt.com/reference/resource-configs/tags">using dbt's <code>tags</code></a>

This ensures the link renders correctly across while keeping the <details> formatting intact.

Why This Approach?

  • A newline after <summary> is unreliable and can break if refactored
  • The HTML <a> tag ensures consistent rendering
  • Maintains readability and proper formatting inside <details>

Screenshots

Before
image

Now
image

Some Markdown engines fail to render inline elements (like links and code formatting) inside `<details>` tags due to missing newlines after `<summary>`. This fix replaces the Markdown-style link with an HTML `<a>` tag, ensuring consistent rendering across different platforms.
Copy link

netlify bot commented Mar 10, 2025

👷 Deploy request for peaceful-bassi-cbf284 pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 17420ec

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Markdown Links Not Rendering Inside <details>
1 participant