Add tip/note formatting to astro markdown (and lots of other plugins)#530
Add tip/note formatting to astro markdown (and lots of other plugins)#530
Conversation
|
🌐 Fork Preview for PR #530 https://pr-530.ddev-com-fork-previews.pages.dev This preview updates automatically when you push changes to your fork. |
tyler36
left a comment
There was a problem hiding this comment.
Looks good to me.
I added a suggestion and "Request changes" to track the removal of the tip.
|
I got claude to add several more features since we were here, lots of goodies.
New Markdown Plugins:
Updated Documentation:
|
stasadev
left a comment
There was a problem hiding this comment.
This is a great reference example and a perfect test to verify if npm update has broken any logic!
| :::danger[Production Deployment Checklist] | ||
| Before deploying to production, verify: | ||
|
|
||
| 1. **Environment Configuration** | ||
|
|
||
| ```bash | ||
| # Check environment variables | ||
| ddev exec printenv | ||
| ``` | ||
|
|
||
| 2. **Database Backup** | ||
| :::warning | ||
| Always create a backup before deployment! | ||
| ::: | ||
|
|
||
| 3. **Run Tests** | ||
|
|
||
| ```bash | ||
| ddev exec phpunit | ||
| ddev exec npm test | ||
| ``` | ||
|
|
||
| 4. **Build Assets** | ||
| - Compile CSS and JavaScript | ||
| - Optimize images | ||
| - Clear caches | ||
|
|
||
| For more information, see the [deployment guide](https://docs.ddev.com/en/stable/users/topics/deploy/) or ask in [DDEV Discord](/s/discord). | ||
| ::: |
There was a problem hiding this comment.
This one didn't work, because :::danger was closed after :::warning was closed with ::: in 2.
| - Optimize images | ||
| - Clear caches | ||
|
|
||
| For more information, see the [deployment guide](https://docs.ddev.com/en/stable/users/topics/deploy/) or ask in [DDEV Discord](/s/discord). |
There was a problem hiding this comment.
| Images are automatically wrapped in semantic HTML `<figure>` elements with captions: | ||
|
|
||
| ```markdown | ||
|  |
MARKDOWN_FORMATTING.md
Outdated
|
|
||
| ```html | ||
| <figure> | ||
| <img src="/img/blog/my-image.jpg" alt="Descriptive alt text" /> |
|
Please take another look @stasadev If there aren't reasons to object to this maybe we can get it in. |
4eccee9 to
373de9e
Compare
Installed and configured markdown enhancement plugins: - remark-gfm: GitHub Flavored Markdown (tables, strikethrough, task lists, autolinks) - remark-unwrap-images: Removes paragraph wrappers from images - remark-toc: Automatic table of contents generation - rehype-external-links: Auto-adds target="_blank" and security attributes - rehype-figure: Wraps images in semantic figure elements with captions - rehype-accessible-emojis: Adds screen reader labels to emojis Created comprehensive demo blog post at /blog/markdown-features-demo showcasing all available markdown features. Updated MARKDOWN_FORMATTING.md with complete documentation and examples. Added markdown resources to contributing guide. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Added textlint-disable comments around task list examples to prevent false positives from the no-todo rule. Updated documentation to show the correct pattern for using task lists. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
373de9e to
91fe882
Compare
|
PR closed. The Cloudflare Pages preview is no longer updated. |
The Issue
I wanted to add a "tip" like we do in docs.ddev.com, for my sharing blog
How This PR Solves The Issue
Adds plugin to do that
Then added a bunch of other plugins
Manual Testing Instructions
Experiment with it.
I imagine people will want some other theming.
The only edit I added was one that doesn't reallyl add value to the v1.25.0 blog, but I wanted to have a way to show it. We can remove it.
Automated Testing Overview
Related Issue Link(s)
Release/Deployment Notes