Ghost Release: 4.2.1

TL;DR

Ghost v4.2.1 is a bug fix release that addresses an issue with markdown for linked images being mangled in some cases. This release ensures proper URL transformation by resolving dependency conflicts in @tryghost/url-utils and related packages.

Highlight of the Release

• Fixed an issue where markdown for linked images was being incorrectly processed
• Resolved dependency conflicts in URL utilities to ensure proper URL transformations

Migration Guide

No migration steps are required for this release. The update can be applied directly without any additional configuration changes.

Upgrade Recommendations

This update is recommended for all Ghost users, especially those who work with markdown content containing linked images. The bug fix ensures proper rendering of markdown content, which is important for content creators who rely on markdown for their posts.

To upgrade:

1. Back up your Ghost installation
2. Follow the standard Ghost update procedure for your installation method (CLI, Docker, etc.)
3. No additional configuration changes are required after updating

Bug Fixes

Markdown Image Processing Fix

This release fixes an issue where markdown for linked images was still being mangled in some cases. The problem was caused by dependency conflicts in the URL utilities:

• Fixed a dependency issue where two versions of @tryghost/url-utils were referenced in yarn.lock, with the older buggy version being used for URL transformations
• Bumped @tryghost/kg-default-cards to increase its minimum allowed version of @tryghost/url-utils, forcing a yarn.lock update
• Bumped @tryghost/kg-markdown-html-renderer to avoid having two versions of that library specified in yarn.lock

This ensures that linked images in markdown content are properly processed and displayed.

New Features

No new features were introduced in this release. This is a bug fix release focused on resolving issues with markdown image processing.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The focus was on fixing the markdown image processing bug.

Impact Summary

This release addresses a specific bug that affected markdown content with linked images. The fix ensures that markdown for linked images is processed correctly, which is particularly important for content creators who use this feature in their posts.

The technical changes involve resolving dependency conflicts in URL utilities to ensure that the correct version is used for URL transformations. This was accomplished by bumping the versions of related packages to force consistent dependency resolution.

While this is a minor bug fix release, it improves the reliability of a core content editing feature, making it an important update for sites that rely heavily on markdown content with images.

Full Release Notes