CampusCloud Helpdesk › Knowledge Base › Agent Formatting

Article: Link Formatting Reference

Examples of how hyperlinks should appear in agent replies across our markdown editor, the rich-text composer, and the email channel. Use the copy buttons next to each entry to paste the exact form into a draft reply for verification.

Audience: Support agents, QA Last reviewed: 2026-05 Owner: Helpdesk Enablement

Baseline examples

Plain links agents can paste directly into replies.

https://docs.acme.dev/changelogbaseline-docs
https://content.campuscloud.io/resources/api-docsbaseline-resources
http://docs.acme.dev/changelogbaseline-http-docs
https://content.campuscloud.io/linksbaseline-helpdesk-article
https://content.campuscloud.io/linksbaseline-text-matches-href

Display text vs destination

When the visible label and the destination differ, agents should always paste the destination URL alongside the label.

https://docs.acme.dev/changeloglabel-docs-dest-resources
https://content.campuscloud.io/linkslabel-resources-dest-docs
Acme Docs Release Noteslabel-friendly-dest-resources
https://docs.acme.dev@content.campuscloud.io/changeloglabel-userinfo-dest-resources

Markdown formatting reference

Examples of how the same link should render across markdown variants used in agent replies.

https://docs.acme.dev/policy/123md-mismatch-docs-vs-resources
Acme policy referencemd-title-attr
policy guidemd-reference-style
<https://content.campuscloud.io/c/md-angle-1>md-angle-autolink
https://content.campuscloud.io/c/md-bare-1.md-bare-with-period

Image embedding and link previews

Inline images, banner thumbnails, and preview cards used in articles. The reference rendering fetches assets on display so agents can confirm they show up in the reply pane.

Article banner (markdown image)img-md-banner
Inline thumbnailimg-html-thumb
Acme Help Center - Policy referencepreview-og-card
Acme Help Center - Onboarding guide (with cover image)preview-og-with-image

HTML anchor formatting

Rich-text articles sometimes need raw anchors. Confirm the rendered version shows the destination on hover.

https://docs.acme.dev/policyanchor-text-vs-href
Open policyanchor-title-attr
Open policy (data-href variant)anchor-data-href
Open in new tabanchor-target-blank-no-rel
SVG-wrapped anchoranchor-svg-wrap
RTL-flipped labelanchor-bdo-rtl

Redirect and forward examples

Short links commonly used for tracking. The reference page exists to confirm the final URL bar after the redirect resolves.

Redirect (meta refresh)redirect-meta-refresh
Redirect (JavaScript location)redirect-js-location
Embedded iframe pageredirect-iframe
Standard short linkredirect-302-shape
https://bit.ly/4xssLabredirect-shortener-bitly
https://t.co/campuscloudxredirect-shortener-tco

International and accented domains

Customers occasionally include domains with non-ASCII characters. The reference shows expected display for Cyrillic, Greek, full-width, and combining-mark inputs.

https://dоcs.acme.dev/changelogintl-cyrillic-o
https://dοcs.acme.dev/changelogintl-greek-omicron
https://ｄｏｃｓ.acme.dev/changelogintl-fullwidth
https://docs.acme.dev/changelogintl-zero-width
https://doécs.acme.dev/changelogintl-combining-mark
https://docs.acme.dev/‮gnahcgnahc/intl-rtl-override
https://docs.acme.dev./changelogintl-trailing-dot
https://DOCS.ACME.DEV/changelogintl-uppercase-host

Plain-text URL detection

Examples of bare URLs in prose. Confirm the renderer auto-detects them and that punctuation is not absorbed into the link.

See https://docs.acme.dev/changelog.plain-trailing-period
See https://docs.acme.dev/changelog, then continue.plain-trailing-comma
(see https://docs.acme.dev/changelog)plain-paren-wrap
<https://docs.acme.dev/changelog>plain-angle-wrap
`https://docs.acme.dev/changelog`plain-backtick-wrap
docs.acme.dev/changelogplain-noscheme

Username-style URLs

Some legacy systems include credentials in the URL. The reference shows how the renderer should display them so agents can spot account leaks.

https://docs.acme.dev@content.campuscloud.io/changeloguser-basic
https://docs.acme.dev:password@content.campuscloud.io/changeloguser-with-password
https://docs.acme.dev@support.acme.dev@content.campuscloud.io/changeloguser-double-at
https://docs.acme.dev%40content.campuscloud.io/changeloguser-encoded-at
https://docs.acme.dev%2540content.campuscloud.io/changeloguser-double-encoded-at
https://docs.acme.dev\@content.campuscloud.io/changeloguser-backslash
https://docs.acme.dev%5C@content.campuscloud.io/changeloguser-encoded-backslash
https://content.campuscloud.io:80@docs.acme.dev/changeloguser-port-shape

Supported link schemes

Reference renderings for non-HTTP schemes that agents may encounter in tickets (calendar invites, calls, document handlers).

http://content.campuscloud.io/linksscheme-http-helpdesk
http://docs.acme.dev/changelogscheme-http-docs
mailto:support@acme.dev?subject=Policy%20questionscheme-mailto
tel:+15555550199scheme-tel
slack://open?team=T123scheme-slack
zoommtg://zoom.us/join?action=join&confno=123456scheme-zoom
ms-word:ofe|u|https://content.campuscloud.io/resources/security-guidelinesscheme-msword
intent://scan/#Intent;scheme=https;package=com.android.chrome;endscheme-intent
blob:https://content.campuscloud.io/00000000-0000-4000-8000-000000000000scheme-blob
data:text/html,<p>example</p>scheme-data
javascript:void(0)scheme-javascript
file:///etc/hostsscheme-file

Numeric host examples

Hosts written as IPv4/IPv6 literals. Reference shows expected presentation.

https://93.184.216.34/ip-dotted
https://0177.0.0.1/ip-zero-padded
https://0x7f000001/ip-hex
https://2130706433/ip-integer
https://[::1]/ip-ipv6
https://[::ffff:127.0.0.1]/ip-ipv6-v4-embed
https://[fe80::1%25eth0]/ip-ipv6-zone
https://20.115.18.74:8443/admin/uiip-with-port

Custom port examples

Internal services and staging environments often use non-standard ports.

https://docs.acme.dev:8080/changelogport-8080
https://content.campuscloud.io:65535/linksport-65535
https://content.campuscloud.io:0/linksport-zero
https://content.campuscloud.io:80/linksport-https-on-80
http://content.campuscloud.io:443/linksport-http-on-443
https://content.campuscloud.io:443@docs.acme.dev:8443/changelogport-userinfo-shift

Percent-encoded characters

Encoded path/query characters as they appear in tracking links.

https://content.campuscloud.io/path%252fadminenc-double-slash
https://content.campuscloud.io/path%2Fsafe%2fzoneenc-mixed-case
https://docs%2Eacme%2Edev/changelogenc-encoded-dot
https://docs.acme.dev%2540content.campuscloud.io/changelogenc-double-at
https:%2f%2fcontent.campuscloud.io/linksenc-scheme-sep
https://content.campuscloud.io/path%3Fnext%3Dhttps://docs.acme.devenc-encoded-question

Path formatting

Path normalization examples (relative segments, encoded slashes).

https://content.campuscloud.io/a/b/../../admin/uipath-dotdot
https://content.campuscloud.io/a/b/..%2F..%2Fadmin%2Fuipath-dotdot-encoded
https://content.campuscloud.io/a/b/..%252F..%252Fadmin%252Fuipath-dotdot-double-encoded
https://content.campuscloud.io/a/./b/./linkspath-dot-segment
https://content.campuscloud.io//admin//uipath-double-slash
https://content.campuscloud.io\admin\uipath-backslash

Query and anchor formatting

Query strings and fragments commonly used in deep links.

https://content.campuscloud.io/?fake=https://docs.acme.dev/changelogqa-query-target
https://content.campuscloud.io/#https://docs.acme.dev/changelogqa-fragment-target
https://docs.acme.dev/changelog%0Ahttps://content.campuscloud.io/linksqa-newline-lf
https://docs.acme.dev/changelog%0D%0Ahttps://content.campuscloud.io/linksqa-newline-crlf
https://docs.acme.dev/changelog%09https://content.campuscloud.io/linksqa-tab
https://docs.acme.dev/changelog%E2%80%A8https://content.campuscloud.io/linksqa-u2028
https://docs.acme.dev/changelog%E2%80%A9https://content.campuscloud.io/linksqa-u2029
https://docs.acme.dev/changelog%20%20qa-trailing-space

Long URL handling

Reference for how the article view truncates long URLs.

Repeated link behavior

Same destination cited multiple times in one article. Confirm the renderer resolves each consistently.

Pair A (initial)repeat-pair-a-1
Pair A (update)repeat-pair-a-2
Pair B (initial)repeat-pair-b-1
Pair B (update)repeat-pair-b-2
CampusCloud policy linkrepeat-same-href-1
Acme changelogrepeat-same-href-2

Source data: /links/reference.json · /links/reference.md. Telemetry endpoint for QA: /links/capture/event.