[{"data":1,"prerenderedAt":452},["ShallowReactive",2],{"guide-html-entities-in-markdown":3},{"id":4,"title":5,"body":6,"date":444,"description":445,"extension":446,"meta":447,"navigation":219,"path":448,"readingTime":240,"seo":449,"stem":450,"__hash__":451},"guides\u002Fguides\u002Fhtml-entities-in-markdown.md","HTML Entities in Markdown Content",{"type":7,"value":8,"toc":438},"minimark",[9,13,18,21,119,122,125,129,132,191,194,197,267,270,274,277,286,306,313,331,334,370,380,384,387,422,425,434],[10,11,12],"p",{},"Markdown provides a clean, minimal syntax for writing structured content, but it cannot represent every character you might need. Special symbols, mathematical operators, accented letters, and reserved characters often require HTML entities—the same notation used in raw HTML. Understanding how to use entities correctly within Markdown files helps you produce accurate, well-formatted content without falling back to raw HTML blocks.",[14,15,17],"h2",{"id":16},"when-markdown-syntax-falls-short","When Markdown Syntax Falls Short",[10,19,20],{},"Markdown handles headings, links, images, code blocks, and basic formatting well. However, several common scenarios exceed its character set:",[22,23,24,43,63,80,102],"ul",{},[25,26,27,31,32,36,37,36,40],"li",{},[28,29,30],"strong",{},"Copyright and trademark symbols:"," ",[33,34,35],"code",{},"©",", ",[33,38,39],{},"®",[33,41,42],{},"™",[25,44,45,31,48,36,51,36,54,36,57,36,60],{},[28,46,47],{},"Mathematical symbols:",[33,49,50],{},"≤",[33,52,53],{},"≥",[33,55,56],{},"≠",[33,58,59],{},"≈",[33,61,62],{},"π",[25,64,65,31,68,36,71,36,74,36,77],{},[28,66,67],{},"Arrows and decorative symbols:",[33,69,70],{},"→",[33,72,73],{},"←",[33,75,76],{},"⇒",[33,78,79],{},"★",[25,81,82,31,93,36,96,36,99],{},[28,83,84,85,88,89,92],{},"Currency symbols beyond ",[33,86,87],{},"$"," and ",[33,90,91],{},"€",":",[33,94,95],{},"¥",[33,97,98],{},"£",[33,100,101],{},"₹",[25,103,104,31,107,36,110,36,113,36,116],{},[28,105,106],{},"Reserved Markdown characters that need literal display:",[33,108,109],{},"*",[33,111,112],{},"_",[33,114,115],{},"#",[33,117,118],{},"|",[10,120,121],{},"You can often type these characters directly if your keyboard supports them and your file uses UTF-8 encoding. But direct insertion has drawbacks: some editors render them inconsistently, grep and diff tools may struggle with multi-byte sequences, and team members with different keyboard layouts may find them hard to type or verify.",[10,123,124],{},"HTML entities solve these problems by expressing every character in ASCII-safe notation.",[14,126,128],{"id":127},"entity-formats-in-markdown","Entity Formats in Markdown",[10,130,131],{},"Markdown processors pass HTML entities through to the rendered output unchanged. The browser then decodes the entity into the corresponding character. Three entity formats are available:",[133,134,135,151],"table",{},[136,137,138],"thead",{},[139,140,141,145,148],"tr",{},[142,143,144],"th",{},"Format",[142,146,147],{},"Example",[142,149,150],{},"Renders As",[152,153,154,167,179],"tbody",{},[139,155,156,160,165],{},[157,158,159],"td",{},"Named entity",[157,161,162],{},[33,163,164],{},"©",[157,166,35],{},[139,168,169,172,177],{},[157,170,171],{},"Decimal numeric",[157,173,174],{},[33,175,176],{},"©",[157,178,35],{},[139,180,181,184,189],{},[157,182,183],{},"Hexadecimal numeric",[157,185,186],{},[33,187,188],{},"©",[157,190,35],{},[10,192,193],{},"Named entities are the most readable and should be preferred when a name exists. Numeric entities work for any Unicode character, including those without named equivalents.",[10,195,196],{},"Here is how entities appear in a Markdown file:",[198,199,204],"pre",{"className":200,"code":201,"language":202,"meta":203,"style":203},"language-markdown shiki shiki-themes github-light github-dark","## Licensing\n\nAll content is © 2026 Acme Corp. The Acme™ brand is a registered® trademark.\n\nFor pricing, see the table below:\n\n| Plan | Price (¥) |\n|------|-----------|\n| Basic | ¥1,000 |\n| Pro | ¥5,000 |\n","markdown","",[33,205,206,214,221,227,232,238,243,249,255,261],{"__ignoreMap":203},[207,208,211],"span",{"class":209,"line":210},"line",1,[207,212,213],{},"## Licensing\n",[207,215,217],{"class":209,"line":216},2,[207,218,220],{"emptyLinePlaceholder":219},true,"\n",[207,222,224],{"class":209,"line":223},3,[207,225,226],{},"All content is © 2026 Acme Corp. The Acme™ brand is a registered® trademark.\n",[207,228,230],{"class":209,"line":229},4,[207,231,220],{"emptyLinePlaceholder":219},[207,233,235],{"class":209,"line":234},5,[207,236,237],{},"For pricing, see the table below:\n",[207,239,241],{"class":209,"line":240},6,[207,242,220],{"emptyLinePlaceholder":219},[207,244,246],{"class":209,"line":245},7,[207,247,248],{},"| Plan | Price (¥) |\n",[207,250,252],{"class":209,"line":251},8,[207,253,254],{},"|------|-----------|\n",[207,256,258],{"class":209,"line":257},9,[207,259,260],{},"| Basic | ¥1,000 |\n",[207,262,264],{"class":209,"line":263},10,[207,265,266],{},"| Pro | ¥5,000 |\n",[10,268,269],{},"The rendered output displays the correct symbols everywhere, and the source remains ASCII-safe.",[14,271,273],{"id":272},"escaping-reserved-characters","Escaping Reserved Characters",[10,275,276],{},"Markdown reserves several characters for its own syntax. When you need to display these characters literally rather than as formatting markers, entities provide a clean escape mechanism.",[10,278,279,280,282,283,285],{},"The pipe character ",[33,281,118],{}," is a common problem inside tables. Since Markdown uses ",[33,284,118],{}," to delimit columns, a literal pipe in cell content breaks the table structure:",[198,287,289],{"className":200,"code":288,"language":202,"meta":203,"style":203},"| Command | Description |\n|---------|-------------|\n| `ls -a | wc -l` | Count all files |   \u003C!-- Broken: pipe splits the cell -->\n",[33,290,291,296,301],{"__ignoreMap":203},[207,292,293],{"class":209,"line":210},[207,294,295],{},"| Command | Description |\n",[207,297,298],{"class":209,"line":216},[207,299,300],{},"|---------|-------------|\n",[207,302,303],{"class":209,"line":223},[207,304,305],{},"| `ls -a | wc -l` | Count all files |   \u003C!-- Broken: pipe splits the cell -->\n",[10,307,308,309,312],{},"Replacing the pipe with ",[33,310,311],{},"|"," fixes the parsing:",[198,314,316],{"className":200,"code":315,"language":202,"meta":203,"style":203},"| Command | Description |\n|---------|-------------|\n| `ls -a | wc -l` | Count all files |\n",[33,317,318,322,326],{"__ignoreMap":203},[207,319,320],{"class":209,"line":210},[207,321,295],{},[207,323,324],{"class":209,"line":216},[207,325,300],{},[207,327,328],{"class":209,"line":223},[207,329,330],{},"| `ls -a | wc -l` | Count all files |\n",[10,332,333],{},"Other characters that benefit from entity escaping include:",[22,335,336,345,353,361],{},[25,337,338,340,341,344],{},[33,339,109],{}," → ",[33,342,343],{},"*"," — prevents italic\u002Fbold parsing",[25,346,347,340,349,352],{},[33,348,112],{},[33,350,351],{},"_"," — prevents italic parsing",[25,354,355,340,357,360],{},[33,356,115],{},[33,358,359],{},"#"," — prevents heading parsing",[25,362,363,340,366,369],{},[33,364,365],{},"~",[33,367,368],{},"~"," — prevents strikethrough parsing",[10,371,372,373,36,376,379],{},"You can also use Markdown's backslash escape (",[33,374,375],{},"\\*",[33,377,378],{},"\\|",") for single characters, but entities are more reliable in complex contexts like table cells where backslash escapes may not be supported by all parsers.",[14,381,383],{"id":382},"compatibility-across-markdown-processors","Compatibility Across Markdown Processors",[10,385,386],{},"Different Markdown processors handle entities with varying levels of support. GitHub Flavored Markdown, CommonMark, and most Nuxt Content configurations parse HTML entities correctly in body text. However, some edge cases exist:",[22,388,389,406,412],{},[25,390,391,394,395,398,399,401,402,405],{},[28,392,393],{},"Inside code spans and code blocks:"," Entities are not decoded. Writing ",[33,396,397],{},"&"," inside backticks renders as the literal text ",[33,400,397],{},", not ",[33,403,404],{},"&",".",[25,407,408,411],{},[28,409,410],{},"Inside frontmatter:"," YAML frontmatter does not process HTML entities. Use Unicode characters directly in frontmatter values.",[25,413,414,417,418,421],{},[28,415,416],{},"In link URLs:"," Some processors decode entities in ",[33,419,420],{},"href"," attributes; others do not. Avoid entities in URLs and use percent-encoding instead.",[10,423,424],{},"When working with Nuxt Content specifically, Markdown files are parsed through a unified pipeline that respects standard HTML entity behavior. Named entities defined in the HTML5 specification are fully supported.",[10,426,427,428,433],{},"To look up entity codes for any character, the ",[429,430,432],"a",{"href":431},"\u002Ftools\u002Fhtml-entity","HTML Entity tool"," provides a searchable reference of named and numeric entities.",[435,436,437],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":203,"searchDepth":216,"depth":216,"links":439},[440,441,442,443],{"id":16,"depth":216,"text":17},{"id":127,"depth":216,"text":128},{"id":272,"depth":216,"text":273},{"id":382,"depth":216,"text":383},"2026-05-28","Using HTML entities in Markdown files for special characters not supported by syntax.","md",{},"\u002Fguides\u002Fhtml-entities-in-markdown",{"title":5,"description":445},"guides\u002Fhtml-entities-in-markdown","HPu-qBuD9w9qmCyDEPEs1E5QJeKgNIlKcTfxvZkvmKw",1780401334321]