Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
0.19.7
->4.1.0
1.4.0
->3.2.1
2.2.1
->5.0.5
2.10.15
->5.4.1
Release Notes
withastro/astro (@astrojs/mdx)
v4.1.0
Compare Source
Minor Changes
#13254
1e11f5e
Thanks @p0lyw0lf! - Adds the ability to process and optimize remote images in Markdown syntax in MDX files.Previously, Astro only allowed local images to be optimized when included using
![]()
syntax. Astro's image service could only display remote images without any processing.Now, Astro's image service can also optimize remote images written in standard Markdown syntax. This allows you to enjoy the benefits of Astro's image processing when your images are stored externally, for example in a CMS or digital asset manager.
No additional configuration is required to use this feature! Any existing remote images written in Markdown will now automatically be optimized. To opt-out of this processing, write your images in Markdown using the JSX
<img/>
tag instead. Note that images located in yourpublic/
folder are still never processed.Patch Changes
1e11f5e
]:v4.0.8
Compare Source
Patch Changes
db252e0
]:v4.0.7
Compare Source
Patch Changes
cf30880
Thanks @ascorbic! - Upgrades Vitev4.0.6
Compare Source
Patch Changes
3d89e62
]:v4.0.5
Compare Source
Patch Changes
3a267f3
Thanks @bluwy! - Reverts withastro/astro@9a3b48c which caused a regression for rendering inline MDX components and MDX files from content collectionsv4.0.4
Compare Source
Patch Changes
#12921
aeb7e1a
Thanks @ascorbic! - Fixes a bug that caused Image component to be imported on MDX pages that did not include images#12913
9a3b48c
Thanks @bluwy! - Makes internalcheck()
function a no-op to allow faster component renders and prevent React 19 component warningsv4.0.3
Compare Source
Patch Changes
739dbfb
Thanks @ascorbic! - Upgrades Vite to pin esbuildv4.0.2
Compare Source
Patch Changes
f13417b
,87231b1
,a71e9b9
]:v4.0.1
Compare Source
Patch Changes
4f2fd0a
Thanks @Princesseuh! - Fixes compatibility with Astro 5v4.0.0
Compare Source
Major Changes
#12231
90ae100
Thanks @bluwy! - Handles the breaking change in Astro where content pages (including.mdx
pages located withinsrc/pages/
) no longer respond withcharset=utf-8
in theContent-Type
header.For MDX pages without layouts,
@astrojs/mdx
will automatically add the<meta charset="utf-8">
tag to the page by default. This reduces the boilerplate needed to write with non-ASCII characters. If your MDX pages have a layout, the layout component should include the<meta charset="utf-8">
tag.If you require
charset=utf-8
to render your page correctly, make sure that your layout components have the<meta charset="utf-8">
tag added.#12008
5608338
Thanks @Princesseuh! - Welcome to the Astro 5 beta! This release has no changes from the latest alpha of this package, but it does bring us one step closer to the final, stable release.Starting from this release, no breaking changes will be introduced unless absolutely necessary.
To learn how to upgrade, check out the Astro v5.0 upgrade guide in our beta docs site.
Minor Changes
#12539
827093e
Thanks @bluwy! - Drops node 21 support#11741
6617491
Thanks @bluwy! - Updates adapter server entrypoint to use@astrojs/mdx/server.js
This is an internal change. Handling JSX in your
.mdx
files has been moved from Astro internals and is now the responsibility of this integration. You should not notice a change in your project, and no update to your code is required.Patch Changes
#12075
a19530e
Thanks @bluwy! - Parses frontmatter ourselves#11861
3ab3b4e
Thanks @bluwy! - Updates@astrojs/markdown-remark
and handle its breaking changes#12533
1b61fdf
Thanks @ematipico! - Fixes a case where the MDX renderer couldn't be loaded when used as a direct dependency of an Astro integration.Updated dependencies [
3ab3b4e
,5608338
,560ef15
,83a2a64
,3ab3b4e
,a19530e
]:v3.1.9
Compare Source
Patch Changes
1d4f6a4
Thanks @bmenant! - Addcomponents
property to MDXInstance type definition (RenderResult and module import)v3.1.8
Compare Source
Patch Changes
710a1a1
]:v3.1.7
Compare Source
Patch Changes
40e7a1b
Thanks @bluwy! - Initializes the MDX processor only when there's.mdx
filesv3.1.6
Compare Source
Patch Changes
c9ae7b1
Thanks @bluwy! - Handles nested root hast node when optimizing MDXv3.1.5
Compare Source
Patch Changes
88ef1d0
Thanks @bluwy! - Fixes CSS in the layout component to be ordered first before any other components in the MDX filev3.1.4
Compare Source
Patch Changes
423614e
Thanks @bluwy! - Fixes stack trace location when failed to parse an MDX file with frontmatterv3.1.3
Compare Source
Patch Changes
49b5145
]:v3.1.2
Compare Source
Patch Changes
b6afe6a
]:v3.1.1
Compare Source
Patch Changes
7d59750
Thanks @wackbyte! - Refactor to use Astro's integration logger for loggingv3.1.0
Compare Source
Minor Changes
#11144
803dd80
Thanks @ematipico! - The integration now exposes a function calledgetContainerRenderer
, that can be used inside the Container APIs to load the relative renderer.v3.0.1
Compare Source
Patch Changes
3cc3e2c
Thanks @Xetera! - Omitting compiler-internal symbol from user components to fix breaking error messagesv3.0.0
Compare Source
Major Changes
#10935
ddd8e49
Thanks @bluwy! - Refactors the MDX transformation to rely only on the unified pipeline. Babel and esbuild transformations are removed, which should result in faster build times. The refactor requires using Astro v4.8.0 but no other changes are necessary.#10935
ddd8e49
Thanks @bluwy! - Allows integrations after the MDX integration to updatemarkdown.remarkPlugins
andmarkdown.rehypePlugins
, and have the plugins work in MDX too.If your integration relies on Astro's previous behavior that prevents integrations from adding remark/rehype plugins for MDX, you will now need to configure
@astrojs/mdx
withextendMarkdownConfig: false
and explicitly specify anyremarkPlugins
andrehypePlugins
options instead.#10935
ddd8e49
Thanks @bluwy! - Renames theoptimize.customComponentNames
option tooptimize.ignoreElementNames
to better reflect its usecase. Its behaviour is not changed and should continue to work as before.#10935
ddd8e49
Thanks @bluwy! - Replaces the internalremark-images-to-component
plugin withrehype-images-to-component
to let users use additional rehype plugins for imagesPatch Changes
#10935
ddd8e49
Thanks @bluwy! - Simplifies plain MDX components as hast element nodes to further improve HTML string inlining for theoptimize
option#10935
ddd8e49
Thanks @bluwy! - Allows Vite plugins to transform.mdx
files before the MDX plugin transforms it#10935
ddd8e49
Thanks @bluwy! - Updates theoptimize
option to group static sibling nodes as a<Fragment />
. This reduces the number of AST nodes and simplifies runtime rendering of MDX pages.#10935
ddd8e49
Thanks @bluwy! - Tags the MDX component export for quicker component checks while rendering#10935
ddd8e49
Thanks @bluwy! - Fixesexport const components
keys detection for theoptimize
option#10935
ddd8e49
Thanks @bluwy! - Improvesoptimize
handling for MDX components with attributes and inline MDX componentsv2.3.1
Compare Source
Patch Changes
#10754
3e7a12c8532411e580fcfdb8445cad8fc8499291
Thanks @rishi-raj-jain! - Fixes an issue where images in MDX required a relative specifier (e.g../
)Now, you can use the standard

syntax in MDX files for images colocated in the same folder: no relative specifier required!There is no need to update your project; your existing images will still continue to work. However, you may wish to remove any relative specifiers from these MDX images as they are no longer necessary:
#10770
88ee63a3ba4488c60348cb821034e6d4a057efd0
Thanks @bluwy! - Removes internal MDX processor onbuildEnd
to free up memoryv2.3.0
Compare Source
Minor Changes
#10689
683d51a5eecafbbfbfed3910a3f1fbf0b3531b99
Thanks @ematipico! - Deprecate support for versions of Node.js older thanv18.17.1
for Node.js 18, older thanv20.0.3
for Node.js 20, and the complete Node.js v19 release line.This change is in line with Astro's Node.js support policy.
Patch Changes
ccafa8d230f65c9302421a0ce0a0adc5824bfd55
]:v2.2.4
Compare Source
Patch Changes
db7f9c87035a0de780536d95cdd9facff00c3c08
Thanks @bluwy! - Removes unnecessary internalrecmaInjectImportMetaEnv
pluginv2.2.3
Compare Source
Patch Changes
2cf116f80cb5e421ab5cc5eb4a654e7b78c1b8de
,374efcdff9625ca43309d89e3b9cfc9174351512
]:v2.2.2
Compare Source
Patch Changes
c585528f446ccca3d4c643f4af5d550b93c18902
]:v2.2.1
Compare Source
Patch Changes
19e42c368184013fc30d1e46753b9e9383bb2bdf
]:v2.2.0
Compare Source
Minor Changes
#10104
a31bbd7ff8f3ec62ee507f72d1d25140b82ffc18
Thanks @remcohaszing! - Changes Astro's internal syntax highlighting to use rehype plugins instead of remark plugins. This provides better interoperability with other rehype plugins that deal with code blocks, in particular with third party syntax highlighting plugins andrehype-mermaid
.This may be a breaking change if you are currently using:
html
raw
.Please review your rendered code samples carefully, and if necessary, consider using a rehype plugin that deals with the generated
element
nodes instead. You can transform the AST of raw HTML strings, or alternatively usehast-util-to-html
to get a string from araw
node.Patch Changes
c081adf998d30419fed97d8fccc11340cdc512e0
,5a9528741fa98d017b269c7e4f013058028bdc5d
,a31bbd7ff8f3ec62ee507f72d1d25140b82ffc18
]:v2.1.1
Compare Source
Patch Changes
44c957f893c6bf5f5b7c78301de7b21c5975584d
]:v2.1.0
Compare Source
Minor Changes
df37366556d46f7abdf82b09e33b08bd94e631b3
Thanks @OliverSpeir! - Allows remark plugins to pass options specifying how images in .mdx files will be optimizedv2.0.6
Compare Source
Patch Changes
53c69dcc82cdf4000aff13a6c11fffe19096cf45
,2f81cffa9da9db0e2802d303f94feaee8d2f54ec
,a505190933365268d48139a5f197a3cfb5570870
]:v2.0.5
Compare Source
Patch Changes
#9706
1539e04a8e5865027b3a8718c6f142885e7c8d88
Thanks @bluwy! - Removes redundant HMR handling codeUpdated dependencies [
165cfc154be477337037185c32b308616d1ed6fa
,e9a72d9a91a3741566866bcaab11172cb0dc7d31
]:v2.0.4
Compare Source
Patch Changes
e72efd6a9a1e2a70488fd225529617ffd8418534
Thanks @bluwy! - Removes environment variables workaround that broke project builds with sourcemapsv2.0.3
Compare Source
Patch Changes
1baf0b0d3cbd0564954c2366a7278794fad6726e
Thanks @sarah11918! - Updates READMEv2.0.2
Compare Source
Patch Changes
e83b5095f
Thanks @florian-lefebvre! - Upgrades vite to latestv2.0.1
Compare Source
Patch Changes
#9366
1b4e91898
Thanks @lilnasy! - Updates NPM package to refer to the stable Astro version instead of a beta.Updated dependencies [
270c6cc27
]:v2.0.0
Compare Source
Major Changes
#9138
abf601233
Thanks @bluwy! - Updates the unified, remark, and rehype dependencies to latest. Make sure to update your custom remark and rehype plugins as well to be compatible with the latest versions.Potentially breaking change: The default value of
markdown.remarkRehype.footnoteBackLabel
is changed from"Back to content"
to"Back to reference 1"
. See themdast-util-to-hast
commit for more information.Patch Changes
abf601233
,addb57c8e
,c7953645e
]:v1.1.5
Compare Source
Patch Changes
4537ecf0d
]:v1.1.4
Compare Source
Patch Changes
c5010aad3
]:v1.1.3
Compare Source
Patch Changes
#8897
5a3d46da1
Thanks @remcohaszing! - Update the README to suggest that users install the official MDX extension for VS Code.Updated dependencies [
26b77b8fe
]:v1.1.2
Compare Source
Patch Changes
2993055be
,c4270e476
,bd5aa1cd3
,f369fa250
,391729686
,f999365b8
,b2ae9ee0c
,0abff97fe
,3bef32f81
]:v1.1.1
Compare Source
Patch Changes
#8737
6f60da805
Thanks @ematipico! - Add provenance statement when publishing the library from CIUpdated dependencies [
21f482657
,6f60da805
,d78806dfe
,d1c75fe15
,aa265d730
,78adbc443
,21e0757ea
,357270f2a
]:v1.1.0
Compare Source
Minor Changes
#8468
a8d72ceae
Thanks @bholmesdev! - Support theimg
component export for optimized images. This allows you to customize how optimized images are styled and rendered.When rendering an optimized image, Astro will pass the
ImageMetadata
object to yourimg
component as thesrc
prop. For unoptimized images (i.e. images using URLs or absolute paths), Astro will continue to pass thesrc
as a string.This example handles both cases and applies custom styling:
v1.0.3
Compare Source
Patch Changes
#8430
f3f62a5a2
Thanks @bluwy! - Use exported remarkShiki and remarkPrism plugins from@astrojs/markdown-remark
Updated dependencies [
f3f62a5a2
,f66053a1e
,0fa483283
]:v1.0.2
Compare Source
Patch Changes
#8438
6df4f3bd9
Thanks @Princesseuh! - Fix errors not having a stacktraceUpdated dependencies [
b3cf1b327
,b92d066b7
]:v1.0.1
Compare Source
Patch Changes
#8405
93a1231f1
Thanks @delucis! - Add location data to MDX compile errorsUpdated dependencies [
7d95bd9ba
,1947ef7a9
,61ad70fdc
,d2f2a11cd
,5126c6a40
,48ff7855b
,923a443cb
,8935b3b46
]:v1.0.0
Compare Source
Major Changes
#8179
6011d52d3
Thanks @matthewp! - Astro 3.0 Release Candidate#8131
43140b87a
Thanks @matthewp! - Support Astro 3 JSX formatThis upgrades the MDX plugin to correctly work with the new JSX render API in Astro 3.
Minor Changes
#8188
d0679a666
Thanks @ematipico! - Remove support for Node 16. The lowest supported version by Astro and all integrations is now v18.14.1. As a reminder, Node 16 will be deprecated on the 11th September 2023.#8169
e79e3779d
Thanks @bluwy! - Remove pre-shiki v0.14 theme names for compatibility. Please rename to the new theme names to migrate:material-darker
->material-theme-darker
material-default
->material-theme
material-lighter
->material-theme-lighter
material-ocean
->material-theme-ocean
material-palenight
->material-theme-palenight
#8188
84af8ed9d
Thanks @ematipico! - Addastro
as peer dependencyPatch Changes
#8188
84af8ed9d
Thanks @ematipico! - Re-orders the MDX plugin to run before Astro's JSX plugin#8188
32669cd47
Thanks @ematipico! - Handlecomponents
exports handling itselfUpdated dependencies [
d0679a666
,db39206cb
,adf9fccfd
,0c7b42dc6
,46c4c0e05
,364d861bd
,2484dc408
,81545197a
,6011d52d3
,c2c71d90c
,cd2d7e769
,80f1494cd
,e45f30293
,c0de7a7b0
,65c354969
,3c3100851
,34cb20021
,a824863ab
,44f7a2872
,1048aca55
,be6bbd2c8
,9e021a91c
,7511a4980
,c37632a20
,acf652fc1
,42785c7b7
,8450379db
,dbc97b121
,7d2f311d4
,2540feedb
,ea7ff5177
,68efd4a8b
,7bd1b86f8
,036388f66
,519a1c4e8
,1f58a7a1b
,2ae9d37f0
,a8f35777e
,70f34f5a3
,5208a3c8f
,84af8ed9d
,f003e7364
,ffc9e2d3d
,732111cdc
,0f637c71e
,33b8910cf
,8a5b0c1f3
,148e61d24
,e79e3779d
,632579dc2
,3674584e0
,1db4e92c1
,e7f872e91
,16f09dfff
,4477bb41c
,55c10d1d5
,3e834293d
,96beb883a
,997a0db8a
,80f1494cd
,0f0625504
,e1ae56e72
,f32d093a2
,f01eb585e
,b76c166bd
, [a87cbe400
](https://redirect.github.com/withastro/astro/commit/a87cbConfiguration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
This PR was generated by Mend Renovate. View the repository job log.