Pluto />\n```\n\nCorrect:\n\n```mdx\n\nJupiter} />\n```\n\n###### Greater than (`>`) and right curly brace (`}`)\n\nJSX does not allow U+003E GREATER THAN (`>`) or U+007D RIGHT CURLY BRACE\n(`}`) literally in text,\nthey need to be encoded as character references\n(or expressions).\nThere is no good reason for this (some JSX parsers agree with us and don’t\ncrash either).\nTherefore,\nin MDX,\nU+003E GREATER THAN (`>`) and U+007D RIGHT CURLY BRACE (`}`) are fine literally\nand don’t need to be encoded.\n\n## Syntax\n\nJSX forms with the following BNF:\n\n\n\nmdx_jsx_flow ::= mdx_jsx *space_or_tab [mdx_jsx *space_or_tab]\nmdx_jsx_text ::= mdx_jsx\n\n; constraint: markdown whitespace (`space_or_tab | eol`) is NOT\n; allowed directly after `<` in order to allow `1 < 3` in markdown.\nmdx_jsx ::=\n '<' [closing]\n [*whitespace name [attributes_after_identifier] [closing]]\n *whitespace '>'\n\nattributes_after_identifier ::=\n 1*whitespace (attributes_boolean | attributes_value) |\n *whitespace attributes_expression |\nattributes_after_value ::=\n *whitespace (attributes_boolean | attributes_expression | attributes_value)\nattributes_boolean ::= key [attributes_after_identifier]\n; Note: in gnostic mode the value of the expression must instead be a single valid ES spread\n; expression\nattributes_expression ::= expression [attributes_after_value]\nattributes_value ::= key initializer [attributes_after_value]\n\nclosing ::= *whitespace '/'\n\nname ::= identifier [local | members]\nkey ::= identifier [local]\nlocal ::= *whitespace ':' *whitespace identifier\nmembers ::= member *member\nmember ::= *whitespace '.' *whitespace identifier\n\nidentifier ::= identifier_start *identifier_part\ninitializer ::= *whitespace '=' *whitespace value\nvalue ::= double_quoted | single_quoted | expression\n; Note: in gnostic mode the value must instead be a single valid ES expression\nexpression ::= '{' *(expression_text | expression) '}'\n\ndouble_quoted ::= '\"' *double_quoted_text '\"'\nsingle_quoted ::= \"'\" *single_quoted_text \"'\"\n\nwhitespace ::= es_whitespace\ndouble_quoted_text ::= char - '\"'\nsingle_quoted_text ::= char - \"'\"\nexpression_text ::= char - '{' - '}'\nidentifier_start ::= es_identifier_start\nidentifier_part ::= es_identifier_part | '-'\n\nspace_or_tab ::= '\\t' | ' '\neol ::= '\\n' | '\\r' | '\\r\\n'\n\n; ECMAScript\n; See “IdentifierStart”: <https://tc39.es/ecma262/#prod-IdentifierStart>\nes_identifier_start ::= ?\n; See “IdentifierPart”: <https://tc39.es/ecma262/#prod-IdentifierPart>\nes_identifier_part ::= ?\n; See “Whitespace”: <https://tc39.es/ecma262/#prod-WhiteSpace>\nes_whitespace ::= ?\n
\n\n\n\nAs the flow construct occurs in flow,\nlike all flow constructs,\nit must be followed by an eol (line ending) or eof (end of file).\n\nThe grammar for JSX in markdown is much stricter than that of HTML in\nmarkdown.\nThe primary benefit of this is that tags are parsed into tokens,\nand thus can be processed.\nAnother,\narguable,\nbenefit of this is that it comes with syntax errors:\nif an author types something that is nonsensical,\nan error is thrown with information about where it happened,\nwhat occurred,\nand what was expected instead.\n\nThis extension supports expressions both aware and unaware to JavaScript\n(respectively gnostic and agnostic).\nDepending on whether acorn is passed,\neither valid JavaScript must be used in expressions,\nor arbitrary text (such as Rust code or so) can be used.\n\nMore on this can be found in\n[§ Syntax of `micromark-extension-mdx-expression`][github-expression-syntax].\n\n## Errors\n\nIn aware (gnostic) mode,\nexpressions are parsed with\n[`micromark-extension-mdx-expression`][github-micromark-expression],\nwhich throws some more errors.\n\n### Unexpected end of file $at, expected $expect\n\nThis error occurs for many different reasons if something was opened but not\nclosed\n(source: `micromark-extension-mdx-jsx`, rule id: `unexpected-eof`).\n\nSome examples are:\n\n```mdx-invalid\n<\n\n\n\n\n\n\n\n\n\n```\n\n### Unexpected lazy line in container, expected line to be…\n\nThis error occurs if a `<` was seen in a container which then has lazy content\n(source: `micromark-extension-mdx-jsx`, rule id: `unexpected-lazy`).\nFor example:\n\n```mdx-invalid\n> \n```\n\n## Tokens\n\nMany tokens are used:\n\n* `mdxJsxFlowTag` for the whole JSX tag (``)\n* `mdxJsxTextTag` ^\n* `mdxJsxFlowTagMarker` for the tag markers (`<`, `>`)\n* `mdxJsxTextTagMarker` ^\n* `mdxJsxFlowTagClosingMarker` for the `/` marking a closing tag (``)\n* `mdxJsxTextTagClosingMarker` ^\n* `mdxJsxFlowTagSelfClosingMarker` for the `/` marking a self-closing tag\n (``)\n* `mdxJsxTextTagSelfClosingMarker` ^\n* `mdxJsxFlowTagName` for the whole tag name (`a:b` in ``)\n* `mdxJsxTextTagName` ^\n* `mdxJsxFlowTagNamePrimary` for the first name (`a` in ``)\n* `mdxJsxTextTagNamePrimary` ^\n* `mdxJsxFlowTagNameMemberMarker` for the `.` marking in members (``)\n* `mdxJsxTextTagNameMemberMarker` ^\n* `mdxJsxFlowTagNameMember` for member names (`b` in ``)\n* `mdxJsxTextTagNameMember` ^\n* `mdxJsxFlowTagNamePrefixMarker` for the `:` between primary and local\n (``)\n* `mdxJsxTextTagNamePrefixMarker` ^\n* `mdxJsxFlowTagNameLocal` for the local name (`b` in ``)\n* `mdxJsxTextTagNameLocal` ^\n* `mdxJsxFlowTagExpressionAttribute` for whole expression attributes\n (``)\n* `mdxJsxTextTagExpressionAttribute` ^\n* `mdxJsxFlowTagExpressionAttributeMarker` for `{`, `}` in expression\n attributes\n* `mdxJsxTextTagExpressionAttributeMarker` ^\n* `mdxJsxFlowTagExpressionAttributeValue` for chunks of what’s inside\n expression attributes\n* `mdxJsxTextTagExpressionAttributeValue` ^\n* `mdxJsxFlowTagAttribute` for a whole normal attribute (``)\n* `mdxJsxTextTagAttribute` ^\n* `mdxJsxFlowTagAttributeName` for the whole name of an attribute (`b:c` in\n ``)\n* `mdxJsxTextTagAttributeName` ^\n* `mdxJsxFlowTagAttributeNamePrimary` for the first name of an attribute (`b`\n in ``)\n* `mdxJsxTextTagAttributeNamePrimary` ^\n* `mdxJsxFlowTagAttributeNamePrefixMarker` for the `:` between primary and\n local (``)\n* `mdxJsxTextTagAttributeNamePrefixMarker` ^\n* `mdxJsxFlowTagAttributeNameLocal` for the local name of an attribute (`c`\n in ``)\n* `mdxJsxTextTagAttributeNameLocal` ^\n* `mdxJsxFlowTagAttributeInitializerMarker` for the `=` between an attribute\n name and value\n* `mdxJsxTextTagAttributeInitializerMarker` ^\n* `mdxJsxFlowTagAttributeValueLiteral` for a string attribute value\n (``)\n* `mdxJsxTextTagAttributeValueLiteral` ^\n* `mdxJsxFlowTagAttributeValueLiteralMarker` for the quotes around a string\n attribute value (`\"` or `'`)\n* `mdxJsxTextTagAttributeValueLiteralMarker` ^\n* `mdxJsxFlowTagAttributeValueLiteralValue` for chunks of what’s inside\n string attribute values\n* `mdxJsxTextTagAttributeValueLiteralValue` ^\n* `mdxJsxFlowTagAttributeValueExpression` for an expression attribute value\n (``)\n* `mdxJsxTextTagAttributeValueExpression` ^\n* `mdxJsxFlowTagAttributeValueExpressionMarker` for the `{` and `}` of\n expression attribute values\n* `mdxJsxTextTagAttributeValueExpressionMarker` ^\n* `mdxJsxFlowTagAttributeValueExpressionValue` for chunks of what’s inside\n expression attribute values\n* `mdxJsxTextTagAttributeValueExpressionValue` ^\n\n## Types\n\nThis package is fully typed with [TypeScript][].\nIt exports the additional type [`Options`][api-options].\n\n## Compatibility\n\nProjects maintained by the unified collective are compatible with maintained\nversions of Node.js.\n\nWhen we cut a new major release,\nwe drop support for unmaintained versions of Node.\nThis means we try to keep the current release line,\n`micromark-extension-mdx-jsx@2`,\ncompatible with Node.js 16.\n\nThis package works with `micromark` version `3` and later.\n\n## Security\n\nThis package is safe.\n\n## Related\n\n* [`micromark-extension-mdxjs`][github-micromark-extension-mdxjs]\n — support all MDX syntax\n* [`mdast-util-mdx-jsx`][github-mdast-util-mdx-jsx]\n — support MDX JSX in mdast\n* [`remark-mdx`][mdxjs-remark-mdx]\n — support all MDX syntax in remark\n\n## Contribute\n\nSee [`contributing.md` in `micromark/.github`][health-contributing] for ways\nto get started.\nSee [`support.md`][health-support] for ways to get help.\n\nThis project has a [code of conduct][health-coc].\nBy interacting with this repository,\norganization,\nor community you agree to abide by its terms.\n\n## License\n\n[MIT][file-license] © [Titus Wormer][wooorm]\n\n\n\n[api-mdx-jsx]: #mdxjsxoptions\n\n[api-options]: #options\n\n[badge-build-image]: https://github.com/micromark/micromark-extension-mdx-jsx/workflows/main/badge.svg\n\n[badge-build-url]: https://github.com/micromark/micromark-extension-mdx-jsx/actions\n\n[badge-coverage-image]: https://img.shields.io/codecov/c/github/micromark/micromark-extension-mdx-jsx.svg\n\n[badge-coverage-url]: https://codecov.io/github/micromark/micromark-extension-mdx-jsx\n\n[badge-downloads-image]: https://img.shields.io/npm/dm/micromark-extension-mdx-jsx.svg\n\n[badge-downloads-url]: https://www.npmjs.com/package/micromark-extension-mdx-jsx\n\n[badge-size-image]: https://img.shields.io/bundlejs/size/micromark-extension-mdx-jsx\n\n[badge-size-url]: https://bundlejs.com/?q=micromark-extension-mdx-jsx\n\n[esmsh]: https://esm.sh\n\n[file-license]: license\n\n[github-acorn]: https://github.com/acornjs/acorn\n\n[github-acorn-options]: https://github.com/acornjs/acorn/blob/96c721dbf89d0ccc3a8c7f39e69ef2a6a3c04dfa/acorn/dist/acorn.d.ts#L16\n\n[github-expression-syntax]: https://github.com/micromark/micromark-extension-mdx-expression/blob/main/packages/micromark-extension-mdx-expression/readme.md#syntax\n\n[github-gist-esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c\n\n[github-mdast-util-from-markdown]: https://github.com/syntax-tree/mdast-util-from-markdown\n\n[github-mdast-util-mdx-jsx]: https://github.com/syntax-tree/mdast-util-mdx-jsx\n\n[github-micromark]: https://github.com/micromark/micromark\n\n[github-micromark-expression]: https://github.com/micromark/micromark-extension-mdx-expression\n\n[github-micromark-extension]: https://github.com/micromark/micromark#syntaxextension\n\n[github-micromark-extension-mdxjs]: https://github.com/micromark/micromark-extension-mdxjs\n\n[health-coc]: https://github.com/micromark/.github/blob/main/code-of-conduct.md\n\n[health-contributing]: https://github.com/micromark/.github/blob/main/contributing.md\n\n[health-support]: https://github.com/micromark/.github/blob/main/support.md\n\n[mdxjs]: https://mdxjs.com\n\n[mdxjs-interleaving]: https://mdxjs.com/docs/what-is-mdx/#interleaving\n\n[mdxjs-remark-mdx]: https://mdxjs.com/packages/remark-mdx/\n\n[nodejs-api-conditions]: https://nodejs.org/api/packages.html#packages_resolving_user_conditions\n\n[npmjs-install]: https://docs.npmjs.com/cli/install\n\n[typescript]: https://www.typescriptlang.org\n\n[wooorm]: https://wooorm.com\n","readmeFilename":"readme.md"}