You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Renamed plugin from "Paste to Current Indentation" to "Paste Mode," reflecting that the scope of the plugin has increased over the past several releases.
- Added the ability for remote images referenced in pasted HTML to be locally downloaded when pasting.
An [Obsidian](https://obsidian.md/) plugin to paste and manage text, including block quotes, that are indented. This plugin helps especially with embedding code, quotes, and other content within lists.
4
4
5
+
_(This plugin was formerly titled "Paste to Current Indentation".)
6
+
5
7
### "Paste modes"
6
8
7
-
Paste to Current Indentation takes over the paste functionality within Obsidian. It has eight "paste modes," which determine what happens when one pastes text within a file in Obsidian. **All of the below will honor the cursor's current indentation when pasting, except for "Passthrough" mode, which uses Obsidian's default paste functionality.**
9
+
Paste Mode takes over the paste functionality within Obsidian. It has eight "paste modes," which determine what happens when one pastes text within a file in Obsidian. **All of the below will honor the cursor's current indentation when pasting, except for "Passthrough" mode, which uses Obsidian's default paste functionality.**
8
10
9
11

10
12
@@ -20,44 +22,60 @@ The current paste mode is displayed in Obsidian's Status Bar:
20
22
21
23

22
24
23
-
### Switching paste mode
25
+
####Switching paste mode
24
26
25
27
There are multiple ways to switch paste modes:
26
28
27
29
1. Clicking the status bar paste mode display will bring up a searchable menu with which you can select a new mode.
28
-
1. Open the Command Palette and search for `Paste to Current Indentation: Cycle Paste Mode`. This command is equivalent to clicking the satus bar.
29
-
1. Open the Command Palette and search for `Paste to Current Indentation: Set Paste Mode`. One command per paste mode is provided.
30
+
1. Open the Command Palette and search for `Paste Mode: Cycle Paste Mode`. This command is equivalent to clicking the satus bar.
31
+
1. Open the Command Palette and search for `Paste Mode: Set Paste Mode`. One command per paste mode is provided.
30
32
- These commands could be used, e.g., with the Obsidian [Quick Add plugin](https://github.com/chhoumann/quickadd/blob/master/docs/Choices/MacroChoice.md) to assign a keyboard command for switching to a given mode and then pasting.
31
-
1. Open the Command Palette and search for `Paste to Current Indentation: Cycle Paste Mode`. This command will cycle through the different paste modes (i.e., from Text mode to Text Blockquote mode, to Markdown mode, to Markdown Blockquote mode, to Passthrough mode, back to Text mode, etc.)
33
+
1. Open the Command Palette and search for `Paste Mode: Cycle Paste Mode`. This command will cycle through the different paste modes (i.e., from Text mode to Text Blockquote mode, to Markdown mode, to Markdown Blockquote mode, to Passthrough mode, back to Text mode, etc.)
32
34
1. Within the plugin's Settings page.
33
35
34
-
### Limitations of Paste Modes
36
+
####Limitations of Paste Modes
35
37
36
38
- The "Markdown" and "Markdown (Blockquote)" modes are automatically disabled **for one-time commands** (i.e., for the "Paste in Markdown Mode," "Paste in Markdown (Blockquote) Mode", and "Paste in Mode (Interactive)" commands) in Obsidian Mobile. This is due to how Obsidian Mobile is allowed to interact with the clipboard.
37
39
If these commands are disabled, a note stating such will appear in the Settings tab for the plugin.
38
40
- Similarly, in Obsidian Mobile, images such as screenshots, and similar files, cannot be pasted from the clipboard, due to how Obsidian Mobile is allowed to interact with the clipboard.
39
41
40
42
### Additional commands
41
43
42
-
- Within the Command Palette, the `Paste to Current Indentation: Toggle blockquote at current indentation` command will toggle blockquote markers at the highlighted text's current level of indentation.
44
+
- Within the Command Palette, the `Paste Mode: Toggle blockquote at current indentation` command will toggle blockquote markers at the highlighted text's current level of indentation.
Block quote markers are customizable via the plugin's Settings page (e.g., if you prefer to use spaces instead of `> `).
47
49
48
-
# Roadmap
50
+
### Additional features
51
+
52
+
#### Dynamic attachment saving
53
+
54
+
- Attachments can be automatically saved to different locations based on the directory of the file being pasted into.
55
+
56
+

57
+
58
+
#### Downloading local copies of linked attachments
59
+
60
+
- When pasting in "Markdown" or "Markdown (Blockquote)" modes, files that are linked in the text (`http://example.com/path/to/file.png`, `file://path/to/file.png`, etc.) can be automatically downloaded locally, based on their source location.
61
+
62
+
#### Automatic character escaping in Markdown
63
+
64
+
Characters that might cause display issues in Markdown (such as `==`, `<`, etc.) can be automatically [escaped](https://www.markdownguide.org/basic-syntax/#characters-you-can-escape) when pasting.
65
+
66
+
### Roadmap
49
67
50
68
I consider this plugin feature-complete for now.
51
69
52
70
Todo:
53
71
54
72
- Add tests
55
73
56
-
# Developing for this plugin
74
+
###Developing for this plugin
57
75
58
76
The documentation below is retained from the [Obsidian Sample Plugin](https://github.com/obsidianmd/obsidian-sample-plugin).
59
77
60
-
## Quickstart guide for development
78
+
####Quickstart guide for development
61
79
62
80
- Clone this repo to a local development folder. For convenience, you can place this folder in your `.obsidian/plugins/your-plugin-name` folder.
63
81
- Install NodeJS, then run `yarn` in the command line under your repo folder.
@@ -67,7 +85,7 @@ The documentation below is retained from the [Obsidian Sample Plugin](https://gi
67
85
- Reload Obsidian to load the new version of the plugin.
68
86
- For updates to the Obsidian API run `yarn` in the command line under this repo's folder.
69
87
70
-
## Developing for mobile
88
+
####Developing for mobile
71
89
72
90
Mobile development can be facilitated using the following workflow:
73
91
@@ -76,18 +94,18 @@ Mobile development can be facilitated using the following workflow:
76
94
1. Follow [the advice in this post](https://forum.obsidian.md/t/debugging-obsidian-mobile-plugins/20913):
77
95
> How to test plugins on Android I think you need to have ADB on your computer installed (I always had that installed; if the following directions don’t work without it, install it); on your android phone you have to enable ADB (it’s under developer settings [tap the build number three times to get these settings]); then connect the phone to your computer over USB; open chrome (or chromium based browser should also work) and type chrome://inspect in the browser. Open obsidian on your phone, then it should appear in the browser. You will have the console and the inspector like you have for desktop Obsidian
78
96
79
-
## Releasing new releases
97
+
####Releasing new releases
80
98
81
99
- Update `manifest.json` with the new version number, such as `1.0.1`, and the minimum Obsidian version required for the latest release.
82
100
- Update the `versions.json` file with `"new-plugin-version": "minimum-obsidian-version"` so older versions of Obsidian can download an older version of the plugin that's compatible.
83
101
- Create new GitHub release using the new version number as the "Tag version". Use the exact version number (i.e., do not include a prefix `v`). See here for an example: https://github.com/obsidianmd/obsidian-sample-plugin/releases
84
102
- Upload the files `manifest.json`, `main.js`, and `styles.css` as binary attachments.
85
103
- Publish the release.
86
104
87
-
## Manually installing the plugin
105
+
###Manually installing the plugin
88
106
89
107
- Copy over `main.js`, `styles.css`, `manifest.json` to your vault `VaultFolder/.obsidian/plugins/obsidian-paste-to-current-indentation/`.
0 commit comments