[{"data":1,"prerenderedAt":65},["Reactive",2],{"blog-post-discord-hyperlink":3},{"slug":4,"title":5,"description":6,"excerpt":7,"date":8,"category":9,"author":10,"keywords":11,"readingMinutes":12,"html":13,"headings":14,"tools":34,"related":37},"discord-hyperlink","Discord Hyperlinks: Masked Links, Hiding the Preview, and Why Yours Is Not Clickable","Write [text](https://example.com) to turn words into a link on Discord. How masked links work, how to stop or hide the preview card, how to spoiler a link, and the mistakes that leave the brackets showing.","To make words into a clickable link on Discord, put the words in square brackets and the URL in parentheses right after:","2026-11-21","Reference","Matthew Rathbone","discord hyperlink, discord masked links, discord embed link, how to hyperlink in discord, discord link text, discord hide link preview",4,"\u003Cp>To make words into a clickable link on Discord, put the words in square brackets and the URL in parentheses right after:\u003C/p>\n\u003Cpre>\u003Ccode>[Read the rules](https://example.com/rules)\n\u003C/code>\u003C/pre>\u003Cp>The message shows \u003Cstrong>Read the rules\u003C/strong> as a link and hides the address. Discord calls this a \u003Cstrong>masked link\u003C/strong>, and it is documented in the \u003Ca href=\"https://support.discord.com/hc/en-us/articles/210298617\">Markdown Text 101\u003C/a> help article: &quot;include the text you want displayed in brackets and then the URL in parentheses&quot;.\u003C/p>\n\u003Cp>This is the same syntax as a \u003Ca href=\"/blog/markdown-hyperlink\">standard Markdown link\u003C/a>, so links copied from a README or from ChatGPT output work as they are.\u003C/p>\n\u003Ch2 id=\"the-four-kinds-of-link-in-a-discord-message\">The four kinds of link in a Discord message\u003C/h2>\n\u003Cdiv class=\"table-responsive\">\u003Ctable class=\"table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>What you type\u003C/th>\n\u003Cth>What readers see\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>https://example.com/rules\u003C/code>\u003C/td>\n\u003Ctd>The URL as a link, usually with a preview card under the message\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>[Read the rules](https://example.com/rules)\u003C/code>\u003C/td>\n\u003Ctd>&quot;Read the rules&quot; as a link\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>&lt;https://example.com/rules&gt;\u003C/code>\u003C/td>\n\u003Ctd>The URL as a link with no preview card\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>||https://example.com/rules||\u003C/code>\u003C/td>\n\u003Ctd>A spoiler bar. The link and its preview stay hidden until clicked.\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\u003C/div>\n\u003Cp>They combine. \u003Ccode>[Read the rules](&lt;https://example.com/rules&gt;)\u003C/code> is a masked link without a preview card.\u003C/p>\n\u003Ch2 id=\"masked-link-rules\">Masked link rules\u003C/h2>\n\u003Cul>\n\u003Cli>\u003Cstrong>No space between \u003Ccode>]\u003C/code> and \u003Ccode>(\u003C/code>.\u003C/strong> \u003Ccode>[text] (url)\u003C/code> shows the brackets.\u003C/li>\n\u003Cli>\u003Cstrong>The URL needs its scheme.\u003C/strong> \u003Ccode>[text](example.com)\u003C/code> is not a link. Write \u003Ccode>https://example.com\u003C/code>.\u003C/li>\n\u003Cli>\u003Cstrong>The link text can be formatted.\u003C/strong> \u003Ccode>[**Sign up here**](https://example.com)\u003C/code> gives a bold link. Put the formatting inside the brackets.\u003C/li>\n\u003Cli>\u003Cstrong>Use words for the link text, not another web address.\u003C/strong> Something like \u003Ccode>[https://google.com](https://example.com)\u003C/code> is the classic phishing pattern. Community servers have a suspicious link filter (Discord describes it in \u003Ca href=\"https://support.discord.com/hc/en-us/articles/7326747355159\">Why was my message not delivered?\u003C/a>), and moderators remove links that disguise where they go.\u003C/li>\n\u003C/ul>\n\u003Ch2 id=\"controlling-the-preview-card\">Controlling the preview card\u003C/h2>\n\u003Cp>When a link is shared in a message, Discord visits the page to fetch its title, description and image and builds the preview card from that. Discord&#39;s \u003Ca href=\"https://support.discord.com/hc/en-us/articles/42500550752919\">link previews article\u003C/a> explains this is done by a bot called Discordbot, and only when a link is actually posted.\u003C/p>\n\u003Cdiv class=\"table-responsive\">\u003Ctable class=\"table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Goal\u003C/th>\n\u003Cth>How\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>No preview for one link\u003C/td>\n\u003Ctd>Wrap the URL in angle brackets: \u003Ccode>&lt;https://example.com&gt;\u003C/code>\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>Hide link and preview behind a click\u003C/td>\n\u003Ctd>Wrap it in spoiler bars: \u003Ccode>||https://example.com||\u003C/code>\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>Never see previews yourself\u003C/td>\n\u003Ctd>User Settings &gt; Text &amp; Images, then turn off the option to show embeds for links posted in chat\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\u003C/div>\n\u003Cp>The angle brackets are not in the Markdown help article, but they are official: Discord&#39;s \u003Ca href=\"https://support.discord.com/hc/en-us/articles/206342858\">How do I disable auto-embed?\u003C/a> article gives it as a tip (&quot;wrap the link in \u003Ccode>&lt; &gt;\u003C/code> tags&quot;) and also describes the settings switch. The setting only changes what you see. The angle brackets change what everyone sees.\u003C/p>\n\u003Cp>One exception, from Discord&#39;s Spoiler Tags article: \u003Cstrong>server invite embeds cannot be hidden with spoiler tags.\u003C/strong> The invite card still shows.\u003C/p>\n\u003Cp>If you own the website and the card looks wrong, the card comes from your page&#39;s Open Graph tags (\u003Ccode>og:title\u003C/code>, \u003Ccode>og:description\u003C/code>, \u003Ccode>og:image\u003C/code>). If no card appears at all, check that your firewall is not blocking Discordbot. Its requests carry a User-Agent containing \u003Ccode>Discordbot\u003C/code>, and Discord publishes its IP ranges for allow lists.\u003C/p>\n\u003Ch2 id=\"why-your-link-is-not-clickable\">Why your link is not clickable\u003C/h2>\n\u003Cdiv class=\"table-responsive\">\u003Ctable class=\"table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>What you see\u003C/th>\n\u003Cth>Cause\u003C/th>\n\u003Cth>Fix\u003C/th>\n\u003C/tr>\n\u003C/thead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>[text](url)\u003C/code> shown with brackets\u003C/td>\n\u003Ctd>A space between \u003Ccode>]\u003C/code> and \u003Ccode>(\u003C/code>, or the URL has no \u003Ccode>https://\u003C/code>\u003C/td>\n\u003Ctd>Remove the space, add the scheme\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>Brackets shown, inside a grey box\u003C/td>\n\u003Ctd>The link is in a code block or inline code\u003C/td>\n\u003Ctd>Move it outside the backticks\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>The link stops halfway through the URL\u003C/td>\n\u003Ctd>The URL contains a space or a closing parenthesis (common with Wikipedia links)\u003C/td>\n\u003Ctd>Replace spaces with \u003Ccode>%20\u003C/code> and \u003Ccode>)\u003C/code> with \u003Ccode>%29\u003C/code>\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>Works in chat, not in a bot message\u003C/td>\n\u003Ctd>Not every embed field renders Markdown. Masked links work in embed descriptions and field values.\u003C/td>\n\u003Ctd>Move the link into the description or a field\u003C/td>\n\u003C/tr>\n\u003Ctr>\n\u003Ctd>The message was not delivered or was removed\u003C/td>\n\u003Ctd>The server&#39;s AutoMod rules or the suspicious link filter caught the link\u003C/td>\n\u003Ctd>Ask the moderators which links are allowed\u003C/td>\n\u003C/tr>\n\u003C/tbody>\u003C/table>\u003C/div>\n\u003Ch2 id=\"links-in-bot-and-webhook-messages\">Links in bot and webhook messages\u003C/h2>\n\u003Cp>Masked links work in message content the same way for bots and webhooks. For embeds, the embed object in Discord&#39;s developer documentation has a \u003Ccode>url\u003C/code> field next to \u003Ccode>title\u003C/code>. Set that to make the title a link rather than trying to put \u003Ccode>[text](url)\u003C/code> in the title.\u003C/p>\n\u003Cp>A related format that is not a hyperlink but looks like one: mentions. \u003Ccode>&lt;#CHANNEL_ID&gt;\u003C/code> links to a channel, \u003Ccode>&lt;@USER_ID&gt;\u003C/code> mentions a user and \u003Ccode>&lt;/name:COMMAND_ID&gt;\u003C/code> links a slash command. These are listed under Message Formatting in the \u003Ca href=\"https://discord.com/developers/docs/reference#message-formatting\">developer docs\u003C/a>.\u003C/p>\n\u003Ch2 id=\"more-discord-formatting\">More Discord formatting\u003C/h2>\n\u003Cul>\n\u003Cli>\u003Ca href=\"/blog/discord-markdown-quickstart-guide\">Discord text formatting cheat sheet\u003C/a>: every option on one page\u003C/li>\n\u003Cli>\u003Ca href=\"/tools/discord-formatter\">Discord Text Formatter\u003C/a>: write a message with links and preview it\u003C/li>\n\u003Cli>\u003Ca href=\"/tools/discord-spoiler-text\">Discord Spoiler Text Generator\u003C/a>: hide text or links behind a click\u003C/li>\n\u003Cli>\u003Ca href=\"/blog/discord-strikethrough\">How to strikethrough on Discord\u003C/a>, \u003Ca href=\"/blog/discord-code-block\">code blocks\u003C/a>, \u003Ca href=\"/blog/discord-small-text-and-big-text\">small and big text\u003C/a>\u003C/li>\n\u003C/ul>\n",[15,19,22,25,28,31],{"id":16,"text":17,"level":18},"the-four-kinds-of-link-in-a-discord-message","The four kinds of link in a Discord message",2,{"id":20,"text":21,"level":18},"masked-link-rules","Masked link rules",{"id":23,"text":24,"level":18},"controlling-the-preview-card","Controlling the preview card",{"id":26,"text":27,"level":18},"why-your-link-is-not-clickable","Why your link is not clickable",{"id":29,"text":30,"level":18},"links-in-bot-and-webhook-messages","Links in bot and webhook messages",{"id":32,"text":33,"level":18},"more-discord-formatting","More Discord formatting",[35,36],"discord-formatter","discord-spoiler-text",[38,47,55],{"slug":39,"title":40,"description":41,"excerpt":42,"date":43,"category":44,"author":10,"keywords":45,"readingMinutes":46},"how-to-insert-a-checkbox-in-markdown","Markdown Checkbox Syntax: `- [ ]` and `- [x]` (and Why Yours Isn't Rendering)","How to write a checkbox in Markdown, the five mistakes that stop it from rendering, the HTML fallback for renderers without task lists, and a free generator for whole checklists.","A Markdown checkbox is a list item that starts with [ ] for unchecked or [x] for checked:","2023-01-08","Tutorial","markdown checkbox, markdown checkbox syntax, how to insert a checkbox in markdown, markdown task list, markdown todo list, github checkbox",3,{"slug":48,"title":49,"description":50,"excerpt":50,"date":51,"category":44,"author":52,"keywords":53,"readingMinutes":54},"how-to-preview-rendered-markdown-in-vim","How to preview rendered Markdown in VIM","VIM is a powerful text editor that can be used to preview rendered Markdown. To do this, you will need to install a plugin called \"instant-markdown-d\" which will allow you to preview the Markdown…","2022-10-19","Matthew Rathbone (with help from OpenAI)","4/19/2023",1,{"slug":56,"title":57,"description":58,"excerpt":59,"date":60,"category":61,"author":62,"keywords":63,"readingMinutes":64},"why-your-markdown-isnt-rendering","Why Your Markdown Isn't Rendering: A Troubleshooting Guide","Markdown looks fine in your editor but renders wrong in production? This guide walks through the most common causes by platform — with specific fixes for each.","You write clean Markdown, hit preview, and something goes wrong. The heading doesn't appear. The code block is mangled. The table renders as pipe characters scattered across a paragraph. The bold…","2026-06-12","troubleshooting","Matt Rathbone","markdown not rendering, markdown rendering issues, markdown broken, markdown display problems, markdown troubleshooting, markdown preview wrong, jekyll markdown not rendering, github markdown broken",8,1795332258312]