@md-plugins/quasar-app-extension-q-press 0.1.0-beta.2 → 0.1.0-beta.21

package/src/templates/init/src/markdown/md-plugins/codeblocks/overview.md

@@ -12,6 +12,7 @@ The Codeblocks Plugin is a powerful tool that enhances the standard code block f
 ## Key Features
 
 - **Syntax Highlighting**: Automatically highlight code syntax for various programming languages.
+- **TwoSlash Hovers**: Opt in to TypeScript-powered hover and query output for richer examples.
 - **Line Numbers**: Display line numbers alongside your code blocks for better readability.
 - **Line Highlighting**: Highlight specific lines of code for emphasis.
 - **Add/Remove Lines**: Highlight add or remove lines of code with ease.
@@ -65,6 +66,36 @@ console.log('Hello, world!')
 ```
 ````
 
+### Code Block with TwoSlash
+
+Add the `twoslash` attribute to TypeScript or JavaScript examples when you want inferred type information, compiler diagnostics, or query output. Hover an identifier in the example below to see the type tooltip.
+
+```ts [twoslash]
+const count = 1
+const label = count.toFixed(0)
+```
+
+````markup
+```ts [twoslash]
+const count = 1
+const label = count.toFixed(0)
+```
+````
+
+If you add a `// ^?` query marker, TwoSlash renders that query result persistently below the matching expression. That is useful for teaching types directly in the page, while normal identifier details remain hover-based.
+
+```ts [twoslash]
+const selectedIcon = 'event' as const
+//    ^?
+```
+
+````markup
+```ts [twoslash]
+const selectedIcon = 'event' as const
+//    ^?
+```
+````
+
 ### Code Block with Restricted Height
 
 ```js [maxheight=300px]
@@ -482,6 +513,8 @@ Look for the `+` and `-` on individual lines at the far-left.
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-codeblocks
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-codeblocks
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-codeblocks
 <<| bash npm |>>
@@ -492,6 +525,8 @@ npm install @md-plugins/md-plugin-codeblocks
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-codeblocks
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-codeblocks
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-codeblocks
 <<| bash npm |>>
@@ -597,11 +632,13 @@ The official NPM name is `@md-plugins/md-plugin-codeblocks`.
 
 ## Installation
 
-You can install the Codeblocks plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Codeblocks plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-codeblocks
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-codeblocks
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-codeblocks
 <<| bash npm |>>
@@ -627,13 +664,13 @@ md.use(codeblocksPlugin, {
   preClass: 'markdown-code', // Optional: Customize the class for the pre tag
   codeClass: '', // Optional: Customize the class for the code tag
   pageScripts: [
-    "import MarkdownPrerender from 'src/.q-press/components/MarkdownPrerender'", // ts file
-    "import MarkdownCopyButton from 'src/.q-press/components/MarkdownCopyButton.vue'",
+    "import MarkdownPrerender from '@/.q-press/components/MarkdownPrerender'", // ts file
+    "import MarkdownCopyButton from '@/.q-press/components/MarkdownCopyButton.vue'",
   ], // Optional: Include page scripts
   langList: [
     { name: 'javascript', aliases: 'javascript|js' },
     { name: 'typescript', aliases: 'typescript|ts' },
-  ], // Optional: Customize Prism languages
+  ], // Optional: Customize Shiki languages
 })
 
 // Now you can use the Codeblocks plugin in your Markdown content
@@ -653,7 +690,7 @@ The Codeblocks plugin accepts the following options:
 - **preClass**: The class to be used for the pre tag. Default is `markdown-pre`.
 - **codeClass**: The class to be used for the code tag. Default is `markdown-code`.
 - **pageScripts**: An array of page scripts to be included.
-- **langList**: Optional Prism languages configuration array. Each item can have a name, optional aliases, and customCopy boolean.
+- **langList**: Optional Shiki languages configuration array. Each item can have a name, optional aliases, and customCopy boolean.
 
 When `defaultLang` is `markup`, the plugin will use the `markup` language for code blocks which means no highlighting will be applied.
 
@@ -682,13 +719,13 @@ md.use(codeblocksPlugin, {
   preClass: 'markdown-pre', // Customize the class for the pre tag
   codeClass: 'markdown-code', // Customize the class for the code tag
   pageScripts: [
-    "import MarkdownPrerender from 'src/.q-press/components/MarkdownPrerender'", // ts file
-    "import MarkdownCopyButton from 'src/.q-press/components/MarkdownCopyButton.vue'",
+    "import MarkdownPrerender from '@/.q-press/components/MarkdownPrerender'", // ts file
+    "import MarkdownCopyButton from '@/.q-press/components/MarkdownCopyButton.vue'",
   ], // Include page scripts
   langList: [
     { name: 'javascript', aliases: 'javascript|js' },
     { name: 'typescript', aliases: 'typescript|ts' },
-  ], // Customize Prism languages
+  ], // Customize Shiki languages
 })
   .use(markdownItAnchor)
   .use(markdownItToc)

package/src/templates/init/src/markdown/md-plugins/containers/overview.md

@@ -89,11 +89,13 @@ The official NPM name is `@md-plugins/md-plugin-containers`.
 
 ## Installation
 
-You can install the Containers plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Containers plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-containers
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-containers
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-containers
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/frontmatter/overview.md

@@ -54,11 +54,13 @@ The official NPM name is `@md-plugins/md-plugin-frontmatter`.
 
 ## Installation
 
-You can install the Frontmatter plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Frontmatter plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-frontmatter
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-frontmatter
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-frontmatter
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/headers/overview.md

@@ -56,11 +56,13 @@ The official NPM name is `@md-plugins/md-plugin-headers`.
 
 ## Installation
 
-You can install the Headers plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Headers plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-headers
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-headers
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-headers
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/image/overview.md

@@ -58,11 +58,13 @@ The official NPM name is `@md-plugins/md-plugin-image`.
 
 ## Installation
 
-You can install the Image plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Image plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-image
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-image
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-image
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/imports/overview.md

@@ -39,11 +39,13 @@ The official NPM name is `@md-plugins/md-plugin-imports`.
 
 ## Installation
 
-You can install the Imports plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Imports plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-imports
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-imports
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-imports
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/inline-code/overview.md

@@ -33,11 +33,13 @@ The official NPM name is `@md-plugins/md-plugin-inlinecode`.
 
 ## Installation
 
-You can install the Inlinecode plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Inlinecode plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-inlinecode
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-inlinecode
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-inlinecode
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/link/advanced.md

@@ -83,7 +83,7 @@ The `link` plugin provides several options for customization. Here are the avail
 #### pageScript
 
 - **Type**: `string`
-- **Default**: `'import MarkdownLink from "src/.q-press/components/MarkdownLink.vue"'`
+- **Default**: `'import MarkdownLink from "@/.q-press/components/MarkdownLink.vue"'`
 - **Description**: The script to import the custom link component.
 
 ### Example Configuration
@@ -99,7 +99,7 @@ const md = new MarkdownIt()
 md.use(linkPlugin, {
   linkTag: 'CustomLink',
   linkToKeyword: 'href',
-  pageScript: 'import CustomLink from "src/components/CustomLink.vue"',
+  pageScript: 'import CustomLink from "@/components/CustomLink.vue"',
 })
 ```
 

package/src/templates/init/src/markdown/md-plugins/link/overview.md

@@ -38,7 +38,7 @@ const md = new MarkdownIt()
 md.use(linkPlugin, {
   linkTag: 'CustomLink', // Optional: Customize the link tag
   linkToKeyword: 'href', // Optional: Customize the link keyword
-  pageScript: 'import CustomLink from "src/components/CustomLink.vue"', // Optional: Add import statement
+  pageScript: 'import CustomLink from "@/components/CustomLink.vue"', // Optional: Add import statement
 })
 
 // Now you can use the Link plugin in your Markdown content
@@ -52,11 +52,13 @@ The official NPM name is `@md-plugins/md-plugin-link`.
 
 ## Installation
 
-You can install the Link plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Link plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-link
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-link
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-link
 <<| bash npm |>>
@@ -76,7 +78,7 @@ const md = new MarkdownIt()
 md.use(linkPlugin, {
   linkTag: 'CustomLink', // Optional: Customize the link tag
   linkToKeyword: 'href', // Optional: Customize the link keyword
-  pageScript: 'import CustomLink from "src/components/CustomLink.vue"', // Optional: Add import statement
+  pageScript: 'import CustomLink from "@/components/CustomLink.vue"', // Optional: Add import statement
 })
 
 // Now you can use the Link plugin in your Markdown content
@@ -107,7 +109,7 @@ const md = new MarkdownIt()
 md.use(linkPlugin, {
   linkTag: 'CustomLink', // Customize the link tag
   linkToKeyword: 'href', // Customize the link keyword
-  pageScript: 'import CustomLink from "src/components/CustomLink.vue"', // Add import statement
+  pageScript: 'import CustomLink from "@/components/CustomLink.vue"', // Add import statement
 })
   .use(markdownItAnchor)
   .use(markdownItToc)

package/src/templates/init/src/markdown/md-plugins/mermaid/advanced.md

@@ -0,0 +1,69 @@
+---
+title: Mermaid Advanced Topics
+desc: Mermaid plugin options and integration details.
+---
+
+The Mermaid plugin is small, but it has two different integration paths:
+
+- **Component mode** is the Q-Press default. It emits `MarkdownMermaid` and lets Vue render Mermaid on the client.
+- **Pre mode** emits a plain `<pre class="mermaid">` block for custom MarkdownIt pipelines.
+
+## Options
+
+| Option          | Type                   | Default              | Description                                  |
+| --------------- | ---------------------- | -------------------- | -------------------------------------------- |
+| `languages`     | `string[]`             | `['mermaid', 'mmd']` | Fence languages treated as Mermaid diagrams. |
+| `renderMode`    | `'component' \| 'pre'` | `'component'`        | Output mode for diagrams.                    |
+| `componentName` | `string`               | `'MarkdownMermaid'`  | Component used in component mode.            |
+| `codeProp`      | `string`               | `'code'`             | Component prop that receives Mermaid source. |
+| `preClass`      | `string`               | `'mermaid'`          | CSS class used in pre mode.                  |
+| `pageScripts`   | `string[]`             | Q-Press import       | Imports added to generated Vue pages.        |
+
+## Component Mode
+
+Use component mode when Markdown output is compiled into Vue components:
+
+```ts
+import MarkdownIt from 'markdown-it'
+import { mermaidPlugin } from '@md-plugins/md-plugin-mermaid'
+
+const md = new MarkdownIt()
+md.use(mermaidPlugin, {
+  componentName: 'MarkdownMermaid',
+  codeProp: 'code',
+})
+```
+
+Component mode adds this import to the generated page when a Mermaid fence is found:
+
+```ts
+import MarkdownMermaid from '@/.q-press/components/MarkdownMermaid.vue'
+```
+
+## Pre Mode
+
+Use pre mode when your app has its own Mermaid bootstrapping:
+
+```ts
+import MarkdownIt from 'markdown-it'
+import { mermaidPlugin } from '@md-plugins/md-plugin-mermaid'
+
+const md = new MarkdownIt()
+md.use(mermaidPlugin, {
+  renderMode: 'pre',
+  preClass: 'mermaid',
+})
+```
+
+Then run Mermaid after the HTML is mounted:
+
+```ts
+import mermaid from 'mermaid'
+
+mermaid.initialize({ startOnLoad: false })
+await mermaid.run({ querySelector: '.mermaid' })
+```
+
+## Security
+
+The Q-Press `MarkdownMermaid` component initializes Mermaid with `securityLevel: 'strict'`. Keep that unless you have a specific reason to allow looser rendering.

package/src/templates/init/src/markdown/md-plugins/mermaid/overview.md

@@ -0,0 +1,73 @@
+---
+title: Mermaid Plugin
+desc: Render Mermaid diagrams from fenced code blocks.
+---
+
+The Mermaid plugin turns `mermaid` and `mmd` fenced code blocks into diagrams. In Q-Press and `viteMdPlugin`, Mermaid diagrams render through the generated `MarkdownMermaid` Vue component so diagrams stay client-side and SSR-safe.
+
+## Example
+
+```mermaid
+flowchart LR
+  Markdown[Markdown file] --> Plugin[md-plugin-mermaid]
+  Plugin --> Component[MarkdownMermaid]
+  Component --> Diagram[Rendered diagram]
+```
+
+## Markdown
+
+````markdown
+```mermaid
+flowchart LR
+  Markdown[Markdown file] --> Plugin[md-plugin-mermaid]
+  Plugin --> Component[MarkdownMermaid]
+  Component --> Diagram[Rendered diagram]
+```
+````
+
+## Installation
+
+You can install the Mermaid plugin using npm, yarn, pnpm, or bun:
+
+```tabs
+<<| bash pnpm |>>
+pnpm add @md-plugins/md-plugin-mermaid mermaid
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-mermaid mermaid
+<<| bash yarn |>>
+yarn add @md-plugins/md-plugin-mermaid mermaid
+<<| bash npm |>>
+npm install @md-plugins/md-plugin-mermaid mermaid
+```
+
+Q-Press installs `mermaid` for generated documentation projects. Direct MarkdownIt users only need `mermaid` if they render diagrams in the browser.
+
+## Basic Usage
+
+```ts
+import MarkdownIt from 'markdown-it'
+import { mermaidPlugin } from '@md-plugins/md-plugin-mermaid'
+
+const md = new MarkdownIt()
+md.use(mermaidPlugin)
+```
+
+The default output is a Vue component:
+
+```html
+<MarkdownMermaid :code="diagramSource"></MarkdownMermaid>
+```
+
+If you own the browser initialization yourself, use plain pre mode:
+
+```ts
+md.use(mermaidPlugin, {
+  renderMode: 'pre',
+})
+```
+
+That renders Mermaid-compatible HTML:
+
+```html
+<pre class="mermaid"><code>flowchart LR...</code></pre>
+```

package/src/templates/init/src/markdown/md-plugins/shared/overview.md

@@ -1,20 +1,24 @@
 ---
-title: Shared Plugin Overview
-desc: Overview of the shared utilities and types for MD-Plugins plugins.
+title: Shared Package Overview
+desc: Overview of the shared utilities and types used by MD-Plugins packages.
 ---
 
-The `shared` plugin provides a set of utilities and types that are used across various MD-Plugins plugins. It serves as a common foundation, ensuring consistency and reducing duplication of code across the different plugins.
+The `@md-plugins/shared` package provides utilities and types used internally by the MD-Plugins packages. It serves as a common foundation, ensuring consistency and reducing duplication across the different plugins.
+
+::: tip
+QPress applications do not need to install or import `@md-plugins/shared` directly. Install it only when you are building a custom Markdown-It plugin or contributing to the MD-Plugins packages themselves.
+:::
 
 ## Key Features
 
 - **Common Utilities**: Provides utility functions that are commonly used across multiple plugins.
 - **Type Definitions**: Includes TypeScript type definitions to ensure type safety and consistency.
 - **Helper Functions**: Offers helper functions to simplify common tasks and operations.
-- **Reusable Components**: Contains reusable components that can be leveraged by other plugins.
+- **Reusable Helpers**: Contains shared helpers that can be leveraged by other MD-Plugins packages.
 
 ## Utilities
 
-The `shared` plugin includes a variety of utility functions that can be used to perform common tasks. Some of the key utilities include:
+The shared package includes a variety of utility functions that can be used to perform common tasks. Some of the key utilities include:
 
 - **String Manipulation**: Functions for manipulating and formatting strings.
 - **Array Operations**: Functions for performing common array operations.
@@ -23,14 +27,12 @@ The `shared` plugin includes a variety of utility functions that can be used to
 
 ## Type Definitions
 
-The `shared` plugin provides TypeScript type definitions that are used across the MD-Plugins project. These type definitions help ensure type safety and consistency. Some of the key type definitions include:
+The shared package provides TypeScript type definitions that are used across the MD-Plugins project. These type definitions help ensure type safety and consistency. Some of the key type definitions include:
 
 - **MarkdownItEnv**: Defines the structure of the environment object used by MD-Plugins plugins.
 - **PluginOptions**: Defines the structure of the options object passed to plugins.
 
-```ts
-import Token from 'markdown-it/lib/token.mjs'
-
+```ts [twoslash]
 /**
  * Escape html chars
  */
@@ -83,6 +85,19 @@ type ResolvePluginOptionsFn = <T extends object, K extends keyof any>(
   defaults: T,
 ) => T
 
+interface LinkPluginOptions {
+  externalTarget?: '_blank' | '_self'
+  externalRel?: string
+}
+
+const linkOptions = resolvePluginOptions({ link: { externalTarget: '_blank' } }, 'link', {
+  externalTarget: '_self',
+  externalRel: 'noopener',
+} satisfies LinkPluginOptions)
+
+const linkTarget = linkOptions.externalTarget
+//    ^?
+
 interface ResolveTitleOptions {
   /**
    * Should allow inline HTML tags or not.
@@ -105,7 +120,7 @@ interface ResolveTitleOptions {
  * Typically using the next token of `heading_open` token
  */
 declare const resolveTitleFromToken: (
-  token: Token,
+  token: unknown,
   { shouldAllowHtml, shouldEscapeText }: ResolveTitleOptions,
 ) => string
 
@@ -135,7 +150,7 @@ interface ResolveHeadersOptions extends ResolveTitleOptions {
  * Resolve headers from markdown-it tokens
  */
 declare const resolveHeadersFromTokens: (
-  tokens: Token[],
+  tokens: unknown[],
   {
     level,
     shouldAllowHtml,
@@ -179,7 +194,7 @@ export {
 
 ## Helper Functions
 
-The `shared` plugin includes a variety of helper functions that simplify common tasks and operations. Some of the key helper functions include:
+The shared package includes a variety of helper functions that simplify common tasks and operations. Some of the key helper functions include:
 
 - **resolveTitleFromToken**: Extracts the title from a Markdown token.
 - **parseFrontmatter**: Parses frontmatter content from a Markdown file.
@@ -190,6 +205,6 @@ The `shared` plugin includes a variety of helper functions that simplify common
 
 ## Conclusion
 
-The `shared` plugin is an essential part of the MD-Plugins project, providing common utilities, type definitions, helper functions, and reusable components. By leveraging the `shared` plugin, you can ensure consistency and reduce duplication of code across your plugins.
+The shared package is an essential internal part of the MD-Plugins project, providing common utilities, type definitions, and helper functions. If you are building custom plugins, you can use it to stay aligned with the same types and helpers used by the official MD-Plugins packages.
 
 Happy coding!

package/src/templates/init/src/markdown/md-plugins/table/overview.md

@@ -101,11 +101,13 @@ The official NPM name is `@md-plugins/md-plugin-table`.
 
 ## Installation
 
-You can install the Table plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Table plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-table
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-table
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-table
 <<| bash npm |>>

package/src/templates/init/src/markdown/md-plugins/title/overview.md

@@ -39,11 +39,13 @@ The official NPM name is `@md-plugins/md-plugin-title`.
 
 ## Installation
 
-You can install the Title plugin using npm, yarn, or pnpm. Choose your preferred method below:
+You can install the Title plugin using npm, yarn, pnpm, or bun. Choose your preferred method below:
 
 ```tabs
 <<| bash pnpm |>>
 pnpm add @md-plugins/md-plugin-title
+<<| bash bun |>>
+bun add @md-plugins/md-plugin-title
 <<| bash yarn |>>
 yarn add @md-plugins/md-plugin-title
 <<| bash npm |>>

package/src/templates/init/src/markdown/other/contact.md

@@ -0,0 +1,37 @@
+---
+title: Contact
+desc: Contacting us
+keys: Other
+---
+
+Have a question about MD-Plugins or Q-Press? We're here to help. Before opening a new issue, please check whether your topic is already covered by the docs or existing GitHub issues.
+
+## Check Existing Resources
+
+### GitHub issues
+
+Search the [MD-Plugins issues](https://github.com/md-plugins/md-plugins/issues) for related bugs, feature requests, and support questions.
+
+### GitHub discussions
+
+If your question is not a bug report or feature request, start with [GitHub Discussions](https://github.com/md-plugins/md-plugins/discussions).
+
+## Provide A Suggestion Or Contribution
+
+### GitHub issues
+
+Report bugs and request features through [GitHub Issues](https://github.com/md-plugins/md-plugins/issues).
+
+### GitHub pull requests
+
+If you have a specific fix or improvement, open a pull request against the [MD-Plugins repository](https://github.com/md-plugins/md-plugins).
+
+## Start A Discussion
+
+### Discord
+
+Use the [Quasar Discord](https://chat.quasar.dev) and head to the `#app-extensions` channel.
+
+### X / Twitter
+
+You can follow MD-Plugins at [@md_plugins](https://twitter.com/md_plugins).

package/src/templates/init/src/markdown/other/contributing/bugs-and-feature-requests.md

@@ -0,0 +1,33 @@
+---
+title: Bugs and Feature Requests
+desc: How to report bugs and request features
+keys: Contributing
+---
+
+## Checking For Known Issues
+
+### GitHub
+
+We use GitHub to track bugs and feature requests. Before opening a new issue, please search the [existing MD-Plugins issues](https://github.com/md-plugins/md-plugins/issues).
+
+### Documentation
+
+Please take a moment to check the relevant plugin, Vite plugin, or Q-Press documentation page. The issue may already be covered there.
+
+## Creating An Issue
+
+Open a [GitHub issue](https://github.com/md-plugins/md-plugins/issues) and include:
+
+- A clear title.
+- The package or Q-Press area involved.
+- Steps to reproduce the problem.
+- Expected behavior and actual behavior.
+- A small reproduction when possible.
+
+## Pull Requests
+
+If you already have a fix, open a pull request against the [MD-Plugins repository](https://github.com/md-plugins/md-plugins/pulls).
+
+## Larger Changes
+
+For broader changes, start a discussion first so we can agree on direction before implementation work begins.

package/src/templates/init/src/markdown/other/contributing/call-to-action.md

@@ -0,0 +1,25 @@
+---
+title: Call to Action
+desc: Things that need help from the community
+keys: Contributing
+---
+
+## Helping Out
+
+This page highlights areas where community help would be especially valuable.
+
+### Examples
+
+Practical examples are one of the best ways to show how MD-Plugins and Q-Press are meant to be used. More focused examples for plugins, containers, code blocks, and Q-Press customization are always useful.
+
+### Tests
+
+Additional tests help keep the package collection stable as the Quasar, Vite, and Markdown ecosystems move forward.
+
+### Documentation
+
+If a page feels unclear, too sparse, or missing a migration note, documentation help is welcome.
+
+### Accessibility
+
+Markdown output should remain readable and accessible in both light and dark modes. Contrast, focus behavior, generated links, and semantic markup are all good areas to improve.