|
| 1 | +--- |
| 2 | +title: PowerToys Advanced Paste for Windows |
| 3 | +description: An AI enhanced tool that enables you to intelligently paste the text from your clipboard into any format needed. |
| 4 | +ms.date: 04/24/2024 |
| 5 | +ms.topic: article |
| 6 | +no-loc: [PowerToys, Windows, Paste as Plain Text, Advanced Paste, Win] |
| 7 | +--- |
| 8 | + |
| 9 | +# Advanced Paste |
| 10 | + |
| 11 | +PowerToys **Advanced Paste** is an AI enhanced tool that enables you to intelligently paste the text from your clipboard into any format needed. |
| 12 | + |
| 13 | +## Getting started |
| 14 | + |
| 15 | +### Enabling |
| 16 | + |
| 17 | +To start using Advanced Paste, enable it in the PowerToys Settings. |
| 18 | + |
| 19 | +### Activating |
| 20 | + |
| 21 | +Open the **Advanced Paste** window with the activation shortcut (default: <kbd>Win</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>). See the [Settings](#settings) section for more information on customizing the activation shortcut and additional shortcut actions. |
| 22 | + |
| 23 | +## Settings |
| 24 | + |
| 25 | +From the Settings menu, the following options can be configured: |
| 26 | + |
| 27 | +| Setting | Description | |
| 28 | +| :--- | :--- | |
| 29 | +| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required. | |
| 30 | +| Custom format preview | Enable to preview the output of the custom format before pasting. | |
| 31 | +| Clipboard history | Enable to automatically save clipboard history. | |
| 32 | +| Open Advanced Paste shortcut | The customizable keyboard command to open the **Advanced Paste** window. | |
| 33 | +| Paste as plain text directly shortcut | The customizable keyboard command to paste as plain text without opening the **Advanced Paste** window. | |
| 34 | +| Paste as Markdown directly shortcut | The customizable keyboard command to paste as Markdown without opening the **Advanced Paste** window. | |
| 35 | +| Paste as JSON directly shortcut | The customizable keyboard command to paste as JSON without opening the **Advanced Paste** window. | |
| 36 | + |
| 37 | +> [!IMPORTANT] |
| 38 | +> It's possible to set <kbd>Ctrl</kbd>+<kbd>V</kbd> as an activation shortcut. This is not recommended, as overriding this shortcut may have unintended consequences. |
| 39 | +
|
| 40 | +## Advanced text paste |
| 41 | + |
| 42 | +Advanced Paste includes several text-based paste options. These options are available in the **Advanced Paste** window, which can be opened using the activation shortcut. You can also paste as plain text, markdown, or JSON directly using the customizable keyboard commands. |
| 43 | + |
| 44 | +:::image type="content" source="../images/pt-advanced-paste.png" alt-text="Advanced Paste screenshot"::: |
| 45 | + |
| 46 | +### Paste as Plain Text |
| 47 | + |
| 48 | +**Paste as Plain Text** enables you to paste text stored in your clipboard, excluding any text-formatting, using a quick key shortcut. Any formatting included with the clipboard text will be replaced with an unformatted version of the text. |
| 49 | + |
| 50 | +:::image type="content" source="../images/pt-paste-as-plain-text.png" alt-text="Paste as Plain Text screenshot"::: |
| 51 | + |
| 52 | +### Paste as JSON |
| 53 | + |
| 54 | +**Paste as JSON** enables you to paste text stored in your clipboard, updating any text-formatting to JSON, using a quick key shortcut. Any formatting included with the clipboard text will be replaced with a JSON formatted version of the text. |
| 55 | + |
| 56 | +Sample input: |
| 57 | + |
| 58 | +```xml |
| 59 | +<note> |
| 60 | + <to>Mr. Smith</to> |
| 61 | + <from>Ms. Nguyen</from> |
| 62 | + <body>Do you like PowerToys?</body> |
| 63 | +</note> |
| 64 | +``` |
| 65 | + |
| 66 | +JSON output: |
| 67 | + |
| 68 | +```json |
| 69 | +{ |
| 70 | + "note": { |
| 71 | + "to": "Mr. Smith", |
| 72 | + "from": "Ms. Nguyen", |
| 73 | + "body": "Do you like PowerToys?" |
| 74 | + } |
| 75 | +} |
| 76 | +``` |
| 77 | + |
| 78 | +### Paste as Markdown |
| 79 | + |
| 80 | +**Paste as Markdown** enables you to paste text stored in your clipboard, updating any text-formatting to markdown, using a quick key shortcut. Any formatting included with the clipboard text will be replaced with a markdown formatted version of the text. |
| 81 | + |
| 82 | +Sample input: |
| 83 | + |
| 84 | +```html |
| 85 | +<b>Paste</b> <i>as</i> <a href="https://en.wikipedia.org/wiki/Markdown">Markdown</a> |
| 86 | +``` |
| 87 | + |
| 88 | +Markdown output: |
| 89 | + |
| 90 | +```md |
| 91 | +**Paste** *as* [Markdown](https://en.wikipedia.org/wiki/Markdown) |
| 92 | +``` |
| 93 | + |
| 94 | +### Paste text with AI |
| 95 | + |
| 96 | +When you paste text with AI, the text is analyzed and formatted based on the context of the text and the prompt provided to the OpenAI call. This feature requires that an OpenAI API key be provided in the PowerToys settings, and that you have available credits in your account. |
| 97 | + |
| 98 | +> [!NOTE] |
| 99 | +> If you use this feature and see an error `API key quota exceeded`, that means you do not have credits in your OpenAI account and would need to purchase them. |
| 100 | +
|
| 101 | +Some examples of how this feature can be used include: |
| 102 | + |
| 103 | +- **Summarize text**: Take long text from the clipboard and ask the AI to summarize it. |
| 104 | +- **Translate text**: Take the text from the clipboard in one language and ask the AI to translate it to another language. |
| 105 | +- **Generate code**: Take a description of a function from the clipboard and ask the AI to generate the code for it. |
| 106 | +- **Transform text**: Take text from the clipboard and ask the AI to rewrite it in a specific style, such as a professional email or a casual message. |
| 107 | +- **Stylize text**: Take text from the clipboard and ask the AI to rewrite it in the style of a well-known author, book, or speaker. |
| 108 | + |
| 109 | +You could ask the AI to paste the text as if it were written by Mark Twain or Shakespeare, for example, or to summarize a long case study. The possibilities are endless. |
| 110 | + |
| 111 | +Sample input: |
| 112 | + |
| 113 | +> The new Advanced Paste feature in PowerToys is now available. You can use it to save time and improve your writing. |
| 114 | +
|
| 115 | +AI output when prompting to "Format the text as if it were written by Mark Twain": |
| 116 | + |
| 117 | +> Say, have you heard the news? The newfangled Advanced Paste feature in PowerToys is finally here! It's a nifty tool that's sure to save you time and spruce up your writing. If you're in the market for a bit of writing wizardry, this here Advanced Paste just might be the ticket for ya. |
| 118 | +
|
| 119 | +> [!NOTE] |
| 120 | +> As with any AI tool, the quality of the output is dependent on the quality of the input. The more context you provide, the better the AI will be able to understand and respond to your request. Be sure to carefully review the output before using it. Please see OpenAI's [privacy](https://openai.com/policies/privacy-policy) and [terms](https://openai.com/policies/terms-of-use) pages for more info on AI usage in this feature. |
| 121 | +
|
| 122 | +## See also |
| 123 | + |
| 124 | +- [Microsoft PowerToys: Utilities to customize Windows](index.md) |
| 125 | +- [Installing PowerToys](install.md) |
| 126 | +- [General settings for PowerToys](general.md) |
0 commit comments