Astro v0.21.0 - differences that aren't bugs/breaking changes

Astro21Diff.md

What's DIFFERENT (but not necessarily buggy/breaking) in Astro 0.21.0 ???

1. How to include a layout in .md files

Previously, front matter REQUIRED a layout property (e.g. layout: ../../layouts/MarkdownPostLayout.astro) Now, it's ALSO OK to include your layout as an import in "setup":

setup: |
  import Layout from '../../layouts/BlogPost.astro'
  import SomeOtherComponent from '../../components/SomeOtherComponent.astro'

3. Inline components inside <Markdown> break some rendering

Previously the following:

<Markdown>
Text: <Component />

Text: <Component />
</Markdown>

Would include the full line in paragraph tags:

<p>Text: <component elements /></p>
<p>Text: <component elements /></p>

Now it fails to generate the <p> tags:

Text: <component elements />
Text: <component elements />

Which causes everything to be on a single line (assuming the component isn’t a block element). One needs to explicitly include the <p> tags. This seems like slightly undesirable behaviour, but I don’t know how easy it is to address if this is handled by a third-party Markdown parser.

4. In .md files, descriptions in square brackets can no longer include double quotation marks. (Single are fine)

X Breaking: ![My first "real" app](/images/image.jpg)

✓ Working: ![My first 'real' app](/images/image.jpg)

5. Importing to use the <Markdown> component in .astro files now requires curly braces, whereas older versions were lenient

X Breaking:

---
 import Markdown from 'astro/components';
---

✓ Working:

---
 import { Markdown } from 'astro/components';
---