Comments (3)
Hi @Because789!
The two things here are actually distinct, but maybe we donโt make that clear enough:
-
The
with-markdown-plugins
example shows using remark/rehype to transform your Markdown content with several plugins -
The caution in the docs you linked to is related specifically to using remark/rehype to transform your Markdown frontmatter
While we donโt recommend modifying frontmatter like this, modifying content is safe and something many Astro sites do, including the Astro docs.
from docs.
Hey @delucis, thanks for your answer, now I understand. Obviously, I didn't check how the plugins in with-markdown-plugins
are actually used. I just saw rehype-slug
and thought, that it probably does something with the frontmatter slug.
I think what tripped me off was, that the caution box sounds like ALL the remark and rehype plugins are dangerous: "Remark and rehype plugins access the raw Markdown or MDX document frontmatter." That sounds pretty absolute, I feel like this could be improved. No idea how though, I'm simply not familiar enough with these plugins.
from docs.
Thanks for this comment! I will be revising our content pages (markdown, MDX, Markdoc and Content Collections) in the next little while and will take this under advisement to make sure we are clear in our recommendations.
from docs.
Related Issues (20)
- View Transitions Script Behavior HOT 1
- Double/triple click headings copy issues HOT 2
- Getting errors creating a new project
- The remark config documentation misses some important information HOT 3
- Clarify how to implement social image URLs HOT 4
- Missing explanation about "themes" from ShikiConfig in syntax highlighting HOT 2
- โ ๏ธ Issue - The implementation of themes from Shiki is not working properly. HOT 1
- Add a bit more help text to client:only description
- Give us feedback form Appearance is not in line with Astro Doc Styling HOT 1
- RTL Docs `Inline Code Snippet` need to be always LTR. HOT 3
- Deploying to GitHub Pages is problematic/flakey HOT 1
- Prettier plugin content is incorrect. HOT 2
- Middleware: unclear that reading cookies/headers behaviour HOT 1
- Improve documentation on fallback content for slots HOT 3
- Unclear refactoring task
- Script Tag CDNs with View Transitions HOT 1
- `prose-p:text-justify` makes recipe less usable HOT 1
- โ ๏ธ Issue @astro/mdx keeps crushing due to rehype dependency HOT 3
- Document `?url` usage in Imports docs HOT 2
- Tutorial says that the rss.xml can't be seen in development but it actually can be HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.