Skip to main content Accueil Créateurs a5c-ai babysitter markdown-mdx
markdown-mdx Advanced Markdown and MDX processing for technical documentation. Parse, validate, lint, and transform Markdown content with support for MDX components, front matter, and remark/rehype plugins.
Aller à l'installation Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/a5c-ai/babysitter --skill markdown-mdxLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Reference for querying the Atlas knowledge graph through its MCP tools — the SECONDARY enrichment/comparison layer that adds best-practice context to systems you have ALREADY scanned from your real sources (`az`, repos, dirs). Use when you need to look up nodes, edges, kinds, clusters, stats, or wiki pages in Atlas to compare against your real inventory. (atlas graph, query atlas, atlas mcp, search the graph, graph neighbors, atlas record, atlas kinds, enrichment layer)
Atlas turns your STATED NEED into a real systems atlas by SCANNING your actual sources (Azure via `az`, git repos, local dirs) and process/data mining them, THEN enriching against the Atlas knowledge graph. Use this skill when asked to inventory/map your real systems, scan your cloud + repos + directories, mine the real processes or data they contain, or collect their real constraints/gotchas. (atlas, scan my systems, inventory our azure account, map my repos, real systems atlas, process mining, data mining, collect nuances, system discovery)
assimilate-popular-workflows This skill should be used when the user asks to "find skills in the wild", "assimilate popular workflows", "discover SKILL.md files in repos", "research external skills", "find workflow patterns", "survey the skill landscape", "what skills exist out there", or wants to investigate public repositories for extractable processes, babysitter plugins, and reusable procedural insights. Searches GitHub for SKILL.md files, classifies repos by archetype, and maintains structured research under docs/reference-repos/.
Métiers associés SOC
Basé sur la classification professionnelle SOC
Explorateur de fichiers
2 fichiers name markdown-mdx description Advanced Markdown and MDX processing for technical documentation. Parse, validate, lint, and transform Markdown content with support for MDX components, front matter, and remark/rehype plugins. allowed-tools Read, Write, Edit, Bash, Glob, Grep backlog-id SK-005 metadata {"author":"babysitter-sdk","version":"1.0.0"} graph {"domains":["domain:software-engineering"],"specializations":["specialization:technical-documentation"],"skillAreas":["skill-area:docs-as-code","skill-area:reference-docs"],"roles":["role:technical-writer","role:documentation-engineer"]}
Markdown/MDX Skill
Advanced Markdown and MDX processing for technical documentation.
Capabilities
Parse and validate Markdown syntax (CommonMark, GFM)
MDX component development and integration
Remark/Rehype plugin configuration
Front matter parsing and validation
Markdown linting (markdownlint rules)
Table formatting and generation
Link validation and URL checking
Convert between documentation formats
Usage Invoke this skill when you need to:
Lint and validate Markdown files
Create or integrate MDX components
Configure remark/rehype pipelines
Validate front matter schemas
Convert between documentation formats
Inputs Parameter Type Required Description inputPath string Yes Path to Markdown/MDX file or directory action string Yes lint, validate, transform, parse-frontmatter outputPath string No Output path for transformed content configPath string No Path to markdownlint config frontmatterSchema object No JSON schema for front matter validation plugins array No Remark/rehype plugins to apply
Input Example {
"inputPath" : "./docs" ,
"action" : "lint" ,
"configPath" : ".markdownlint.json"
}
Output Structure
Lint Output {
"files" : 42 ,
"errors" : 5 ,
"warnings" : 12 ,
"issues" : [
{
"file" : "docs/getting-started.md" ,
"line" : 15 ,
"rule" : "MD022" ,
"message" : "Headings should be surrounded by blank lines" ,
"severity" : "error"
}
] ,
"fixable" : 8
}
Front Matter Parse Output {
"file" : "docs/api/users.md" ,
"frontmatter" : {
"title" : "Users API" ,
"description" : "User management endpoints" ,
"tags" : [ "api" , "users" ] ,
"sidebar_position" : 3
} ,
"valid" : true ,
"content" : "# Users API\n\nThis document..."
}
Markdown Patterns
CommonMark Extensions # Heading 1
## Heading 2 {#custom-id}
Paragraph with **bold** , *italic* , and `code` .
> Blockquote with
> multiple lines
- Unordered list
- With items
- Nested item
1. Ordered list
2. With numbers
| Column 1 | Column 2 |
|----------|----------|
| Cell 1 | Cell 2 |
[Link text ](https://example.com "Title" )
```javascript
const code = 'block';
### GitHub Flavored Markdown (GFM)
```markdown
## GFM Extensions
### Task Lists
- [x] Completed task
- [ ] Incomplete task
### Tables
| Left | Center | Right |
|:-----|:------:|------:|
| L | C | R |
### Strikethrough
~~deleted text~~
### Autolinks
https://example.com
### Footnotes
Here's a sentence with a footnote[^1].
[^1]: This is the footnote.
### Alerts
> [!NOTE]
> Useful information.
> [!WARNING]
> Critical content.
MDX Patterns
MDX Components ---
title: Interactive Guide
---
import { Tabs, TabItem } from '@site/src/components/Tabs';
import CodeBlock from '@theme/CodeBlock';
# Getting Started
<Tabs>
<TabItem value="npm" label="npm">
```bash
npm install my-package
```
</TabItem>
<TabItem value="yarn" label="yarn">
```bash
yarn add my-package
```
</TabItem>
</Tabs>
## Configuration
<CodeBlock language="json" title="config.json">
{`{
"setting": "value"
}`}
</CodeBlock>
export const Highlight = ({children, color}) => (
<span style={{backgroundColor: color, padding: '0.2rem'}}>
{children}
</span>
);
This is <Highlight color="#25c2a0">highlighted text</Highlight>.
MDX Component Library
export function Callout ({ type = 'info' , title, children } ) {
const styles = {
info : { bg : '#e7f5ff' , border : '#339af0' },
warning : { bg : '#fff3bf' , border : '#fab005' },
error : { bg : '#ffe3e3' , border : '#fa5252' },
success : { bg : '#d3f9d8' , border : '#40c057' }
};
return (
<div style ={{
backgroundColor: styles [type ].bg ,
borderLeft: `4px solid ${styles [type ].border }`,
padding: '1rem ',
margin: '1rem 0 '
}}>
{title && <strong > {title}</strong > }
{children}
</div > import { Callout } from '@site/src/components/Callout';
<Callout type="warning" title="Deprecation Notice">
This API will be removed in version 3.0.
</Callout>
Markdownlint Configuration
.markdownlint.json {
"default" : true ,
"MD013" : false ,
"MD033" : {
"allowed_elements" : [ "details" , "summary" , "Tabs" , "TabItem" ]
} ,
"MD041" : false ,
"MD024" : {
"siblings_only" : true } ,
"MD046" : {
"style" : "fenced"
} ,
"MD048" : {
"style" : "backtick"
}
}
markdownlint-cli2 Configuration
config:
default: true
MD013: false
globs:
- "docs/**/*.md"
- "!node_modules"
- "!.git"
ignores:
- "CHANGELOG.md"
customRules:
- markdownlint-rule-search-replace
Remark/Rehype Plugins
remark.config.mjs import remarkGfm from 'remark-gfm' ;
import remarkFrontmatter from 'remark-frontmatter' ;
import remarkMdxFrontmatter from 'remark-mdx-frontmatter' ;
import remarkToc from 'remark-toc' ;
import remarkSlug from 'remark-slug' ;
export default {
plugins : [
remarkGfm,
remarkFrontmatter,
remarkMdxFrontmatter,
[remarkToc, { heading : 'contents' , tight : true }],
remarkSlug
]
};
rehype.config.mjs import rehypeSlug from 'rehype-slug' ;
import rehypeAutolinkHeadings from 'rehype-autolink-headings' ;
import rehypePrism from 'rehype-prism-plus' ;
export default {
plugins : [
rehypeSlug,
[rehypeAutolinkHeadings, { behavior : 'wrap' }],
[rehypePrism, { showLineNumbers : true }]
]
};
Front Matter Schema
JSON Schema for Validation {
"$schema" : "http://json-schema.org/draft-07/schema#" ,
"type" : "object" ,
"required" : [ "title" ] ,
"properties" : {
"title" : {
"type" : "string" ,
"minLength" : 1 ,
"maxLength" : 100
} ,
"description" : {
"type" : "string" ,
"maxLength" : 300
} ,
"tags" : {
"type" : "array" ,
"items" : { "type" : "string" }
} ,
"sidebar_position" : {
"type" : "integer" ,
"minimum" : 0
} ,
"draft" : {
"type" : "boolean" ,
"default" : false }
} ,
"additionalProperties" : false }
Workflow
Parse content - Load Markdown/MDX filesExtract front matter - Parse YAML front matterValidate structure - Check against schemaLint content - Apply markdownlint rulesTransform - Apply remark/rehype pluginsReport findings - Output validation results
Dependencies {
"devDependencies" : {
"markdownlint-cli2" : "^0.12.0" ,
"remark" : "^15.0.0" ,
"remark-gfm" : "^4.0.0" ,
"remark-frontmatter" : "^5.0.0" ,
"remark-mdx" : "^3.0.0" ,
"rehype" : "^13.0.0" ,
"gray-matter" : "^4.0.0" ,
"ajv" : "^8.0.0"
}
}
CLI Commands
npx markdownlint-cli2 "docs/**/*.md"
npx markdownlint-cli2 --fix "docs/**/*.md"
node scripts/validate-frontmatter.js docs/
npx remark docs/guide.md -o build/guide.html
Best Practices Applied
Use ATX-style headings (#)
Consistent list markers (- for unordered)
Fenced code blocks with language identifier
Front matter for metadata
Descriptive link text (not "click here")
Alt text for all images
One sentence per line for better diffs
References
Target Processes
style-guide-enforcement.js
docs-testing.js
docs-audit.js
content-strategy.js
