feat: Add option to disable inline task overlay for aliased links

src/editor/ReadingModeTaskLinkProcessor.ts

@@ -163,6 +163,18 @@ export class ReadingModeTaskLinkProcessor {
 			// Get the original link text for display
 			const originalText = linkEl.textContent || `[[${originalLinkPath}]]`;
 
+			// Check for alias exclusion
+			if (this.plugin.settings.disableOverlayOnAlias) {
+				// In reading mode, we check if the displayed text differs from the path or title
+				// If it does, it's likely an alias/custom text
+				const currentText = linkEl.textContent || "";
+
+				// If text doesn't match path AND doesn't match task title, it's an alias
+				if (currentText !== originalLinkPath && currentText !== taskInfo.title) {
+					return;
+				}
+			}
+
 			// Parse display text if it's a piped link
 			let displayText: string | undefined;
 			const linkContent = linkEl.textContent || "";

src/editor/TaskLinkOverlay.ts

@@ -273,6 +273,14 @@ export function buildTaskLinkDecorations(
 					continue;
 				}
 
+				// Check for alias exclusion
+				if (plugin.settings.disableOverlayOnAlias) {
+					// Skip Wikilinks with pipes [[Path|Alias]]
+					if (link.type === "wikilink" && link.match.includes("|")) {
+						continue;
+					}
+				}
+
 				// Parse the link to get the link path (handle both wikilinks and markdown links)
 				const parsed =
 					link.type === "wikilink"

src/settings/defaults.ts

@@ -289,6 +289,7 @@ export const DEFAULT_SETTINGS: TaskNotesSettings = {
 	pomodoroMobileSidebar: "tab",
 	// Editor defaults
 	enableTaskLinkOverlay: true,
+	disableOverlayOnAlias: false,
 	enableInstantTaskConvert: true,
 	useDefaultsOnInstantConvert: true,
 	enableNaturalLanguageInput: true,

src/settings/tabs/featuresTab.ts

@@ -54,6 +54,18 @@ export function renderFeaturesTab(
 			);
 
 			if (plugin.settings.enableTaskLinkOverlay) {
+				group.addSetting((setting) =>
+					configureToggleSetting(setting, {
+						name: translate("settings.features.overlays.aliasExclusion.name"),
+						desc: translate("settings.features.overlays.aliasExclusion.description"),
+						getValue: () => plugin.settings.disableOverlayOnAlias,
+						setValue: async (value: boolean) => {
+							plugin.settings.disableOverlayOnAlias = value;
+							save();
+						},
+					})
+				);
+
 				group.addSetting((setting) => {
 					setting
 						.setName("Inline Task Card Properties")

src/types/settings.ts

@@ -124,6 +124,7 @@ export interface TaskNotesSettings {
 	pomodoroMobileSidebar: "tab" | "left" | "right"; // where to open pomodoro view on mobile
 	// Editor settings
 	enableTaskLinkOverlay: boolean;
+	disableOverlayOnAlias: boolean;
 	enableInstantTaskConvert: boolean;
 	useDefaultsOnInstantConvert: boolean;
 	enableNaturalLanguageInput: boolean;