VCOF0114

OmniFocus: Transform Links

These two plug-ins tranform links within the text of the note of the selected project or task:

• Links to Markdown • Converts styled link objects into markdown link elements: [link title](link URL)
• Markdown to Links • Converts markdown link elements [link title](link URL) into styled link objects.

Scope and Syntax

Language: English (United States 🇺🇸 · Great Britain 🇬🇧 · Australia 🇦🇺 · Canada 🇨🇦) • Scope: OmniFocus

Command phrase variations (words in [brackets] are optional):

• “Links to Markdown”
• “Markdown to Links”

Requirements

(OmniFocus 4 TestFlight only)

• Applications: OmniFocus 4 (macOS)
• System: macOS 12, iPadOS 15, iOS 15

Video: Transform Links

These two plug-ins tranform links within the text of the note of the selected project or task.

PLAY (E) PAUSE BACK REWIND

Downloads

• ⇩ COMMANDS-FILE OmniFocus 4.0 (macOS)
• ⇩ SHORTCUT-LINK (“Links to Mark Down”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Mark Down to Links”) (iOS · iPadOS · visionOS)

Script Code

Here is the script code for the command:

Links to Markdown

Converts styled link objects into markdown link element.

IMPORTANT: Do no run this plug-in if the note currently contains markdown links. Instead, first convert the markdown links to link objects, then run the script.

Links to Markdown
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()

		sel = document.windows[0].selection
		items = sel.databaseObjects.filter(
			item => (item instanceof Project || item instanceof Task)
		)
		if(items.length === 1){
			noteObj = items[0].noteText
			runRanges = noteObj.ranges(TextComponent.AttributeRuns)
			changeCount = 0
			runRanges.reverse().forEach(range => {
				runStyle = noteObj.styleForRange(range)
				linkStr = runStyle.get(Style.Attribute.Link).string
				if(linkStr.length > 0){
					linkTitle = noteObj.textInRange(range).string
					if(linkTitle === linkStr){linkTitle = "LINK"}
					mdLinkStr = `[${linkTitle}](${linkStr})`
					linkObj = new Text(mdLinkStr, runStyle)
					noteObj.replace(range, linkObj)
					changeCount += 1
				}
			})
			
			response = (changeCount === 1) ? "One link":`${changeCount} links`
			if(changeCount === 0){response = "No links"}
			response = `${response} transformed.`
			utterance = createUtterance(response)
			synthesizer.speakUtterance(utterance)
		} else {
			throw {
				name: "Selection Issue",
				message: "Please select a single project or task."
			}
		}
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		//new Alert(err.name, err.message).show()
	}
})();

Markdown to Links

Converts the markdown link elements into styled link objects.

Markdown to Links
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()

		sel = document.windows[0].selection
		items = sel.databaseObjects.filter(
			item => (item instanceof Project || item instanceof Task)
		)
		if(items.length === 1){
			item = items[0]
			noteObj = item.noteText
			regexMdLinks = /!?\[([^\]]*)\]\(([^\)]+)\)/
			strToMatch = regexMdLinks.source
			findParams = [Text.FindOption.RegularExpression]
			resultRange = noteObj.range
			while (resultRange !== null) {
				rangeToSearch = noteObj.range
				resultRange = noteObj.find(regexMdLinks.source, findParams, rangeToSearch)
				if(resultRange){
					mdLinkStr = noteObj.textInRange(resultRange).string
					x = mdLinkStr.indexOf("]")
					y = mdLinkStr.indexOf("(")
					mdLinkTitle = mdLinkStr.substr(1, x - 1)
					mdLinkURLStr = mdLinkStr.substr(y + 1, mdLinkStr.length)
					mdLinkURLStr = mdLinkURLStr.slice(0, -1)
					linkURL = URL.fromString(mdLinkURLStr)
					if (linkURL){
						currentStyle = noteObj.styleForRange(resultRange)
						linkObj = new Text(mdLinkTitle, currentStyle)
						style = linkObj.styleForRange(linkObj.range)
						style.set(Style.Attribute.Link, linkURL)
						noteObj.replace(resultRange, linkObj) 
					} else {console.error("Bad URL:", mdLinkURLStr)}
				}
			}

			response = (changeCount === 1) ? "One item":`${changeCount} items`
			if(changeCount === 0){response = "No items"}
			response = `${response} transformed.`
			utterance = createUtterance(response)
			synthesizer.speakUtterance(utterance)
		} else {
			throw {
				name: "Selection Issue",
				message: "Please select a single project or task."
			}
		}
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		//new Alert(err.name, err.message).show()
	}
})();