gitea-yuany3721/vuepress-theme-plume
1
0
Fork 1
mirror of https://github.com/pengzhanbo/vuepress-theme-plume.git synced 2026-05-01 12:38:12 +08:00
Code Issues Packages Projects Releases Wiki Activity
vuepress-theme-plume/en/guide/markdown/basic/index.html

161 lines
209 KiB
HTML
Raw Blame History

<!doctype html><html lang="en-US"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><meta name="generator" content="VuePress 2.0.0-rc.28" /><meta name="theme" content="VuePress Theme Plume 1.0.0-rc.195" /><script id="check-mac-os">document.documentElement.classList.toggle('mac', /Mac|iPhone|iPod|iPad/i.test(navigator.platform))</script><script id="check-dark-mode">;(function () {const um= localStorage.getItem('vuepress-theme-appearance') || 'auto';const sm = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;const isDark = um === 'dark' || (um !== 'light' && sm);document.documentElement.dataset.theme = isDark ? 'dark' : 'light';})();</script><script type="application/ld+json">{"@context":"https://schema.org","@type":"Article","headline":"Basic","image":["https://theme-plume.vuejs.press/path/to/img.jpg","https://theme-plume.vuejs.press/path/to/img.jpg \"Optional title\""],"dateModified":"2025-10-07T15:13:09.000Z","author":[]}</script><meta property="og:url" content="https://theme-plume.vuejs.press/en/guide/markdown/basic/"><meta property="og:site_name" content="Plume Theme"><meta property="og:title" content="Basic"><meta property="og:description" content="This document is forked from vuepress-theme-hope, following the MIT license. Markdown is a markup language that can be written using a plain text editor. Through simple syntax, ..."><meta property="og:type" content="article"><meta property="og:image" content="https://theme-plume.vuejs.press/path/to/img.jpg"><meta property="og:locale" content="en-US"><meta property="og:locale:alternate" content="zh-CN"><meta property="og:updated_time" content="2025-10-07T15:13:09.000Z"><meta property="article:tag" content="markdown"><meta property="article:tag" content="Guide"><meta property="article:modified_time" content="2025-10-07T15:13:09.000Z"><link rel="alternate" hreflang="zh-cn" href="https://theme-plume.vuejs.press/guide/markdown/basic/"><link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png"><link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png"><meta name="google-site-verification" content="AaTP7bapCAcoO9ZGE67ilpy99GL6tYqtD30tRHjO9Ps"><title>Basic | Guide | Plume Theme</title><meta name="description" content="This document is forked from vuepress-theme-hope, following the MIT license. Markdown is a markup language that can be written using a plain text editor. Through simple syntax, ..."><link rel="preload" href="/assets/style-DnsiUdcZ.css" as="style"><link rel="stylesheet" href="/assets/style-DnsiUdcZ.css"><link rel="modulepreload" href="/assets/app-B2DsuqVi.js"><link rel="modulepreload" href="/assets/plugin-vue_export-helper-CxTVcLa7.js"><link rel="modulepreload" href="/assets/chunk-DseTPa7n.js"><link rel="modulepreload" href="/assets/preload-helper-ca-nBW7U.js"><link rel="modulepreload" href="/assets/composables-DsGBjQEX.js"><link rel="modulepreload" href="/assets/VPHomeHero-D17FBc21.js"><link rel="modulepreload" href="/assets/composables-3J5ZwNFM.js"><link rel="modulepreload" href="/assets/client-C5e5tgZO.js"><link rel="modulepreload" href="/assets/theme-colors-bZHGy5AR.js"><link rel="modulepreload" href="/assets/VPButton-CjpnmuwG.js"><link rel="modulepreload" href="/assets/runtime-core.esm-bundler-CZvn3YaB.js"><link rel="modulepreload" href="/assets/runtime-dom.esm-bundler-DTRCDnrc.js"><link rel="modulepreload" href="/assets/dist-CMy7OcvW.js"><link rel="modulepreload" href="/assets/codeRepl-BV_0qCs3.js"><link rel="modulepreload" href="/assets/VPCopyright-DQT4wCul.js"><link rel="modulepreload" href="/assets/basic-CU9Q0btT.js"></head><body><div id="app"><!--[--><!--[--><div class="theme-plume vp-layout" vp-container data-v-a5aadcf6><!--[--><!--[--><!--]--><!--[--><span tabindex="-1" data-v-26bc9d93></span><a href="#VPContent" class="vp-skip-link visually-hidden" data-v-26bc9d93> Skip to content </a><!--]--><!----><header class="vp-nav" data-v-a5aadcf6 data-v-f81e37e9><div class="vp-navbar" vp-navbar data-v-f81e37e9 data-v-b90976a4><div class="wrapper" data-v-b90976a4><div class="container" data-v-b90976a4><div class="title" data-v-b90976a4><div class="vp-navbar-title has-sidebar" data-v-b90976a4 data-v-f77fe1b1><a class="vp-link link no-icon title" href="/en/" data-v-f77fe1b1><!--[--><!--[--><!--]--><!--[--><!--[--><!--[--><img class="vp-image dark logo" style="" src="/plume.png" alt data-v-414baac9><!--]--><!--[--><img class="vp-image light logo" style="" src="/plume.png" alt data-v-414baac9><!--]--><!--]--><!--]--><span data-v-f77fe1b1>Plume Theme</span><!--[--><!--]--><!--]--><!--[--><!--]--><!----></a></div></div><div class="content" data-v-b90976a4><div class="content-body" data-v-b90976a4><!--[--><!--]--><div class="vp-navbar-search search" data-v-b90976a4><div class="search-wrapper" data-v-62419745><!----><div id="local-search" data-v-62419745><button type="button" class="mini-search mini-search-button" aria-label="Search" data-v-62419745><span class="mini-search-button-container"><span class="mini-search-search-icon vpi-mini-search" aria-label="search icon"></span><span class="mini-search-button-placeholder">Search</span></span><span class="mini-search-button-keys"><kbd class="mini-search-button-key"></kbd><kbd class="mini-search-button-key">K</kbd></span></button></div></div></div><!--[--><!--]--><nav aria-labelledby="main-nav-aria-label" class="vp-navbar-menu menu" data-v-b90976a4 data-v-b42927e7><span id="main-nav-aria-label" class="visually-hidden" data-v-b42927e7>Main Navigation</span><!--[--><!--[--><a class="vp-link link navbar-menu-link active" href="/en/guide/intro/" tabindex="0" data-v-b42927e7 data-v-29cf8989><!--[--><span class="vp-icon vpi-icon-park-outline-guide-board" style="" aria-hidden data-provider="iconify" data-v-29cf8989></span><span data-v-29cf8989>Guide</span><!----><!--]--><!--[--><!--]--><!----></a><!--]--><!--[--><a class="vp-link link navbar-menu-link" href="/en/config/intro/" tabindex="0" data-v-b42927e7 data-v-29cf8989><!--[--><span class="vp-icon vpi-icon-park-outline-setting-two" style="" aria-hidden data-provider="iconify" data-v-29cf8989></span><span data-v-29cf8989>Config</span><!----><!--]--><!--[--><!--]--><!----></a><!--]--><!--[--><a class="vp-link link navbar-menu-link" href="/en/blog/" tabindex="0" data-v-b42927e7 data-v-29cf8989><!--[--><span class="vp-icon vpi-material-symbols-article-outline" style="" aria-hidden data-provider="iconify" data-v-29cf8989></span><span data-v-29cf8989>Blog</span><!----><!--]--><!--[--><!--]--><!----></a><!--]--><!--[--><div class="vp-flyout vp-navbar-menu-group" data-v-b42927e7 data-v-15bfbb59><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-15bfbb59><span class="text" data-v-15bfbb59><span class="vp-icon vpi-icon-park-outline-more-three" style="" aria-hidden data-provider="iconify" data-v-15bfbb59></span><!----><span data-v-15bfbb59>More</span><!----><span class="vpi-chevron-down text-icon" data-v-15bfbb59></span></span></button><div class="menu" data-v-15bfbb59><div class="vp-menu" data-v-15bfbb59 data-v-f3964f32><div class="items" data-v-f3964f32><!--[--><!--[--><div class="vp-menu-link" data-v-f3964f32 data-v-e06ddb34><a class="vp-link link" href="/en/faq/" data-v-e06ddb34><!--[--><span class="vp-icon vpi-wpf-faq" style="" aria-hidden data-provider="iconify" data-v-e06ddb34></span> FAQ <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--><!--[--><div class="vp-menu-link" data-v-f3964f32 data-v-e06ddb34><a class="vp-link link" href="/en/tools/" data-v-e06ddb34><!--[--><span class="vp-icon vpi-jam-tools" style="" aria-hidden data-provider="iconify" data-v-e06ddb34></span> Theme Tools <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--><!--[--><div class="vp-menu-link" data-v-f3964f32 data-v-e06ddb34><a class="vp-link link" href="/en/friends/" data-v-e06ddb34><!--[--><span class="vp-icon vpi-carbon-friendship" style="" aria-hidden data-provider="iconify" data-v-e06ddb34></span> Friend Links <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--><!--[--><div class="vp-menu-group" data-v-f3964f32 data-v-6c770283><p class="title" data-v-6c770283><span class="vp-icon vpi-logos-vue bg" style="" aria-hidden data-provider="iconify" data-v-6c770283></span><span data-v-6c770283>Vuepress</span></p><!--[--><!--[--><div class="vp-menu-link" data-v-6c770283 data-v-e06ddb34><a class="vp-link link vp-external-link-icon" href="https://v2.vuepress.vuejs.org" target="_blank" rel="noopener noreferrer" data-v-e06ddb34><!--[--><span class="vp-icon vpi-logos-vue bg" style="" aria-hidden data-provider="iconify" data-v-e06ddb34></span> Official Docs <!----><!--]--><!--[--><!--]--><span class="visually-hidden">(Open in new window)</span></a></div><!--]--><!--[--><div class="vp-menu-link" data-v-6c770283 data-v-e06ddb34><a class="vp-link link vp-external-link-icon" href="https://ecosystem.vuejs.press/" target="_blank" rel="noopener noreferrer" data-v-e06ddb34><!--[--><span class="vp-icon vpi-logos-vue bg" style="" aria-hidden data-provider="iconify" data-v-e06ddb34></span> Ecosystem <!----><!--]--><!--[--><!--]--><span class="visually-hidden">(Open in new window)</span></a></div><!--]--><!--]--></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--[--><div class="vp-flyout vp-navbar-menu-group" data-v-b42927e7 data-v-15bfbb59><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-15bfbb59><span class="text" data-v-15bfbb59><span class="vp-icon vpi-codicon-versions" style="" aria-hidden data-provider="iconify" data-v-15bfbb59></span><!----><span data-v-15bfbb59>1.0.0-rc.195</span><span class="vp-badge tip vp-menu-badge" style="" data-v-15bfbb59 data-v-52c8341f><!--[-->New<!--]--></span><span class="vpi-chevron-down text-icon" data-v-15bfbb59></span></span></button><div class="menu" data-v-15bfbb59><div class="vp-menu" data-v-15bfbb59 data-v-f3964f32><div class="items" data-v-f3964f32><!--[--><!--[--><div class="vp-menu-link" data-v-f3964f32 data-v-e06ddb34><a class="vp-link link" href="/en/changelog/" data-v-e06ddb34><!--[--><!----> Changelog <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--><!--[--><div class="vp-menu-link" data-v-f3964f32 data-v-e06ddb34><a class="vp-link link" href="/en/contributing/" data-v-e06ddb34><!--[--><!----> Contributing <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!--[--><!--]--><div class="vp-flyout vp-navbar-translations translations" data-v-b90976a4 data-v-e0a18246 data-v-15bfbb59><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="Languages" data-v-15bfbb59><span class="text" data-v-15bfbb59><!----><span class="vpi-languages option-icon" data-v-15bfbb59></span><!----><!----><span class="vpi-chevron-down text-icon" data-v-15bfbb59></span></span></button><div class="menu" data-v-15bfbb59><div class="vp-menu" data-v-15bfbb59 data-v-f3964f32><!----><!--[--><!--[--><div class="items" data-v-e0a18246><p class="title" data-v-e0a18246>English</p><!--[--><div class="vp-menu-link" data-v-e0a18246 data-v-e06ddb34><a class="vp-link link" href="/guide/markdown/basic/" data-v-e06ddb34><!--[--><!----> 简体中文 <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="vp-navbar-appearance appearance" data-v-b90976a4 data-v-17780d44><button class="vp-switch vp-switch-appearance" type="button" role="switch" aria-checked="false" title data-v-17780d44 data-v-cbe77d87 data-v-36bbbf22><span class="check" data-v-36bbbf22><span class="icon" data-v-36bbbf22><!--[--><span class="vpi-sun sun" data-v-cbe77d87></span><span class="vpi-moon moon" data-v-cbe77d87></span><!--]--></span></span></button></div><div class="vp-social-links vp-navbar-social-links social-links" data-v-b90976a4 data-v-ba70645a data-v-5dc0805d><!--[--><a class="vp-social-link no-icon" href="https://github.com/pengzhanbo/vuepress-theme-plume" aria-label="github" title="github" target="_blank" rel="noopener" data-v-5dc0805d data-v-c5bc2a09><span class="vp-icon vpi-simple-icons-github" style="" aria-hidden data-provider="iconify" data-v-c5bc2a09></span></a><a class="vp-social-link no-icon" href="https://qm.qq.com/q/FbPPoOIscE" aria-label="qq" title="qq" target="_blank" rel="noopener" data-v-5dc0805d data-v-c5bc2a09><span class="vp-icon vpi-simple-icons-qq" style="" aria-hidden data-provider="iconify" data-v-c5bc2a09></span></a><!--]--></div><div class="vp-flyout vp-navbar-extra extra" data-v-b90976a4 data-v-7e94ae84 data-v-15bfbb59><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-15bfbb59><span class="vpi-more-horizontal icon" data-v-15bfbb59></span></button><div class="menu" data-v-15bfbb59><div class="vp-menu" data-v-15bfbb59 data-v-f3964f32><!----><!--[--><!--[--><div class="group translations" data-v-7e94ae84><p class="trans-title" data-v-7e94ae84>English</p><!--[--><div class="vp-menu-link" data-v-7e94ae84 data-v-e06ddb34><a class="vp-link link" href="/guide/markdown/basic/" data-v-e06ddb34><!--[--><!----> 简体中文 <!----><!--]--><!--[--><!--]--><!----></a></div><!--]--></div><div class="group appearance" data-v-7e94ae84><div class="item appearance" data-v-7e94ae84><p class="label" data-v-7e94ae84>Appearance</p><div class="appearance-action" data-v-7e94ae84><button class="vp-switch vp-switch-appearance" type="button" role="switch" aria-checked="false" title data-v-7e94ae84 data-v-cbe77d87 data-v-36bbbf22><span class="check" data-v-36bbbf22><span class="icon" data-v-36bbbf22><!--[--><span class="vpi-sun sun" data-v-cbe77d87></span><span class="vpi-moon moon" data-v-cbe77d87></span><!--]--></span></span></button></div></div></div><div class="group social" data-v-7e94ae84><div class="item social-links" data-v-7e94ae84><div class="vp-social-links social-links-list" data-v-7e94ae84 data-v-5dc0805d><!--[--><a class="vp-social-link no-icon" href="https://github.com/pengzhanbo/vuepress-theme-plume" aria-label="github" title="github" target="_blank" rel="noopener" data-v-5dc0805d data-v-c5bc2a09><span class="vp-icon vpi-simple-icons-github" style="" aria-hidden data-provider="iconify" data-v-c5bc2a09></span></a><a class="vp-social-link no-icon" href="https://qm.qq.com/q/FbPPoOIscE" aria-label="qq" title="qq" target="_blank" rel="noopener" data-v-5dc0805d data-v-c5bc2a09><span class="vp-icon vpi-simple-icons-qq" style="" aria-hidden data-provider="iconify" data-v-c5bc2a09></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="vp-navbar-hamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="nav-screen" data-v-b90976a4 data-v-2122c19e><span class="container" data-v-2122c19e><span class="top" data-v-2122c19e></span><span class="middle" data-v-2122c19e></span><span class="bottom" data-v-2122c19e></span></span></button></div></div></div></div><div class="divider" data-v-b90976a4><div class="divider-line" data-v-b90976a4></div></div></div><!----></header><div class="vp-local-nav reached-top has-sidebar" data-v-a5aadcf6 data-v-5171e520><button class="menu" aria-expanded="false" aria-controls="SidebarNav" data-v-5171e520><span class="vpi-align-left menu-icon" data-v-5171e520></span><span class="menu-text" data-v-5171e520>Menu</span></button><div class="vp-local-nav-outline-dropdown" style="--vp-vh:0px;" data-v-5171e520 data-v-d5044118><!----><!----></div></div><!--[--><aside class="vp-sidebar" vp-sidebar data-v-28af193e><div class="curtain" data-v-28af193e></div><nav id="SidebarNav" class="nav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-28af193e><span id="sidebar-aria-label" class="visually-hidden" data-v-28af193e> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-71ba64cb><section class="vp-sidebar-item sidebar-item level-0 collapsible" data-v-71ba64cb data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-carbon-idea" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h2 class="text" data-v-ab4803a9><span data-v-ab4803a9>Quick Start</span><!----></h2><button type="button" class="caret" aria-label="Collapse Quick Start" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-tooltip-text-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/intro/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Introduction</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-grommet-icons-install" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/usage/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Installation & Usage</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ph-tree-structure-bold" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/project-structure/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Project Structure</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><section class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fluent-list-bar-tree-16-regular" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/collection/" data-v-ab4803a9><!--[--><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>Collection</span><!----></h3><!--]--><!--[--><!--]--><!----></a><!----></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-post-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/collection/post/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Post Collection</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-streamline-ultimate-sidebar-line-left" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/collection/doc/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Doc Collection</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ph-sidebar-duotone" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/sidebar/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Sidebar</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mingcute-edit-4-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/write/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Writing Articles</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-markdown-outline-rounded" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/auto-frontmatter/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>frontmatter</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-light-language" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/locales/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Internationalization</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-deployed-code-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/deployment/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Deployment</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-clarity-bundle-solid" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/optimize-build/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Build Optimization</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section></div><div class="no-transition group" data-v-71ba64cb><section class="vp-sidebar-item sidebar-item level-0 collapsible has-active" data-v-71ba64cb data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fluent-mdl2-edit-create" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h2 class="text" data-v-ab4803a9><span data-v-ab4803a9>Write</span><!----></h2><button type="button" class="caret" aria-label="Collapse Write" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><section class="vp-sidebar-item sidebar-item level-1 collapsible has-active" data-v-ab4803a9 data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-markdown-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>markdown</span><!----></h3><button type="button" class="caret" aria-label="Collapse markdown" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fluent-markdown-20-filled" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/basic/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Basic</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fluent-mdl2-auto-enhance-on" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/extensions/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Extensions</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ic-outline-data-object" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/attrs/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Attribute Support</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-emoji-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/emoji/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>emoji</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-tabler-math" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/math/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Mathematical Formulas</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-table-plus" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/table/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Table Enhancement</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-grommet-icons-emoji" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/icons/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Icons</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mingcute-mark-pen-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/mark/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Mark</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-weui-eyes-off-outlined" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/plot/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Plot Text</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-tooltip-question-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/abbreviation/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Abbreviations</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-iconamoon-comment-add-light" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/annotation/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Annotation</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-message-text-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/container/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Tip Containers</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-alert-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/github-alerts/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>GitHub Alerts</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-solar-card-broken" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/card/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Card</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-streamline-steps-number" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/steps/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Steps</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-file-tree" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/file-tree/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>File Tree</span><span class="vp-badge warning vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->Change<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-stash-side-peek" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/code-tree/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Code Tree</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-solar-text-field-linear" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/field/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Field Container</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-vaadin-tabs" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/tabs/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Tab Groups</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-uiw-qrcode" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/qrcode/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>QR Code</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-timeline-text-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/timeline/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Timeline</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fxemoji-window bg" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/window/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Demo Container</span><span class="vp-badge warning vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->Change<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-light-flex-no-wrap" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/flex/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Flex Container</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-carbon-collapse-categories" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/collapse/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Collapse Panel</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-gg-npm" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/npm-to/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>npmTo Container</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-streamline-desktop-help" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/caniuse/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Can I Use</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-cil-chat-bubble" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/chat/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Chat Records</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fluent-table-simple-include-16-regular" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/include/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>File Inclusion</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-eos-icons-env" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/env/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Environment preset</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-simple-icons-obsidian" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/obsidian/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Obsidian Compatibility</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><section class="vp-sidebar-item sidebar-item level-1 collapsible collapsed" data-v-ab4803a9 data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ph-code-bold" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>code block</span><!----></h3><button type="button" class="caret" aria-label="Expand code block" aria-expanded="false" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div style="display:none;" data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ic-outline-code" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/intro/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Introduction</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-majesticons-code-block-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/features/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Feature Support</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ph-code" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/copy-code/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Copy Code</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fluent-group-list-20-filled" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/group/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Code Grouping</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-import" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/import/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Import Code</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-experiment-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/markdown/twoslash/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Two Slash</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><section class="vp-sidebar-item sidebar-item level-1 collapsible collapsed" data-v-ab4803a9 data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-carbon-demo" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>code repl</span><!----></h3><button type="button" class="caret" aria-label="Expand code repl" aria-expanded="false" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div style="display:none;" data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-icon-park-outline-html-five" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/repl/frontend/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Frontend Demo</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-simple-icons-rust" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/repl/rust/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Rust</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-devicon-plain-go" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/repl/golang/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Golang</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-tabler-brand-kotlin" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/repl/kotlin/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Kotlin</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-devicon-plain-python" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/repl/python/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Python</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mingcute-codepen-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/code-pen/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Code Pen</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-bxl-jsfiddle" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/jsfiddle/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Js Fiddle</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-lucide-codesandbox" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/code-sandbox/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Code Sandbox</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-simple-icons-replit" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/code/replit/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Replit</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><section class="vp-sidebar-item sidebar-item level-1 collapsible collapsed" data-v-ab4803a9 data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-chart-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>charts</span><!----></h3><button type="button" class="caret" aria-label="Expand charts" aria-expanded="false" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div style="display:none;" data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-solar-chart-bold" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/chart/chartjs/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>chart.js</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-raphael-piechart" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/chart/echarts/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>ECharts</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-file-icons-mermaid" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/chart/mermaid/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Mermaid</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-f7-flowchart" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/chart/flowchart/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>flowchart</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ri-mind-map" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/chart/markmap/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>markmap</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-arcticons-uml-class-editor" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/chart/plantuml/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>PlantUML</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><section class="vp-sidebar-item sidebar-item level-1 collapsible collapsed" data-v-ab4803a9 data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-dashicons-embed-video" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>resource embedded</span><!----></h3><button type="button" class="caret" aria-label="Expand resource embedded" aria-expanded="false" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div style="display:none;" data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-teenyicons-pdf-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/embed/pdf/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>PDF Reader</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ri-bilibili-fill" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/embed/video/bilibili/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Bilibili Video</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-lets-icons-video-fill" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/embed/video/acfun/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>AcFun Video</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-youtube" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/embed/video/youtube/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>YouTube Video</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-icon-park-outline-video" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/embed/video/artplayer/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>ArtPlayer Video</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-rivet-icons-audio" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/embed/audio/reader/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Audio Reader</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><!--]--></div></div></section></div><div class="no-transition group" data-v-71ba64cb><section class="vp-sidebar-item sidebar-item level-0 collapsible" data-v-71ba64cb data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-lucide-box" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h2 class="text" data-v-ab4803a9><span data-v-ab4803a9>Features</span><!----></h2><button type="button" class="caret" aria-label="Collapse Features" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-raphael-smile2" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/icon/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Icons</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-search" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/content-search/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Content Search</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ri-image-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/image-preview/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Image Preview</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-la-comment" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/comments/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Comments</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mingcute-announcement-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/bulletin/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Bulletin</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-encryption-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/encryption/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Encryption</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-simple-icons-contributorcovenant" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/contributors/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Contributors</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-radix-icons-activity-log" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/changelog/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Changelog</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-lucide-creative-commons" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/copyright/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Article Copyright</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-light-branding-watermark-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/watermark/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Article Watermark</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-carbon-friendship" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/friend-links/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Friend Links Page</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-lucide-replace" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/replace-assets/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Replace Assets</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-tabler-seo" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/seo/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>SEO</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-sitemap-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/sitemap/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>sitemap</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ri-ai" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/features/llmstxt/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>LLMs txt</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section></div><div class="no-transition group" data-v-71ba64cb><section class="vp-sidebar-item sidebar-item level-0 collapsible" data-v-71ba64cb data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-uiw-component" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h2 class="text" data-v-ab4803a9><span data-v-ab4803a9>Component</span><!----></h2><button type="button" class="caret" aria-label="Collapse Component" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-iconamoon-badge-light" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/badge/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Badge</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-grommet-icons-emoji" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/icon/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Icon</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-lets-icons-hide-eye" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/plot/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Plot Text</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-solar-card-broken" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/card/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Card</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-solar-card-send-linear" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/link-card/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Link Card</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fa-photo" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/image-card/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Image Card</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-vaadin-grid-h" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/card-grid/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Card Grid</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ri-layout-masonry-line" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/card-masonry/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Masonry Card</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-tabler-container" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/home-box/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Home Layout Container</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-octicon-repo-16" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/github-repo-card/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Repo Card</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-akar-icons-npm-fill" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/npm-badge/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Npm Badge</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-dashicons-images-alt2" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/components/swiper/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Swiper</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section></div><div class="no-transition group" data-v-71ba64cb><section class="vp-sidebar-item sidebar-item level-0 collapsible" data-v-71ba64cb data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-dashboard-customize-outline-rounded" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h2 class="text" data-v-ab4803a9><span data-v-ab4803a9>Customization</span><!----></h2><button type="button" class="caret" aria-label="Collapse Customization" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><section class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-material-symbols-home-outline" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/custom-home/" data-v-ab4803a9><!--[--><h3 class="text" data-v-ab4803a9><span data-v-ab4803a9>Custom Homepage</span><!----></h3><!--]--><!--[--><!--]--><!----></a><!----></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-2 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-icon-park-outline-effects" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/custom-home/hero-effect/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Hero Background Effects</span><span class="vp-badge tip vp-menu-badge" style="" data-v-ab4803a9 data-v-52c8341f><!--[-->New<!--]--></span></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-icon-park-outline-theme" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/custom-style/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Custom Styles</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-ph-layout-duotone" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/layout-slots/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Layout Slots</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-carbon-cics-sit-overrides" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/component-overrides/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Component Overrides</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section></div><div class="no-transition group" data-v-71ba64cb><section class="vp-sidebar-item sidebar-item level-0 collapsible" data-v-71ba64cb data-v-ab4803a9><div class="item" role="button" tabindex="0" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-mdi-api" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><h2 class="text" data-v-ab4803a9><span data-v-ab4803a9>API</span><!----></h2><button type="button" class="caret" aria-label="Collapse API" aria-expanded="true" tabindex="-1" data-v-ab4803a9><span class="vpi-chevron-right caret-icon" data-v-ab4803a9></span></button></div><div data-v-ab4803a9 data-v-ab4803a9><div class="items" data-v-ab4803a9><!--[--><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-nimbus-browser" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/api/client/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Client</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><div class="vp-sidebar-item sidebar-item level-1 is-link" data-v-ab4803a9 data-v-ab4803a9><div class="item" data-v-ab4803a9><div class="indicator" data-v-ab4803a9></div><span class="vp-icon vpi-fa6-brands-node" style="" aria-hidden data-provider="iconify" data-v-ab4803a9></span><a class="vp-link link link" href="/en/guide/api/node/" data-v-ab4803a9><!--[--><p class="text" data-v-ab4803a9><span data-v-ab4803a9>Node</span><!----></p><!--]--><!--[--><!--]--><!----></a><!----></div><!----></div><!--]--></div></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="vp-sidebar-control" data-v-28af193e><button type="button" class="toggle-sidebar-btn" aria-label="Toggle sidebar" data-v-28af193e><span class="vpi-sidebar-close" data-v-28af193e></span></button></div><!--]--><!--[--><div id="VPContent" vp-content class="vp-content has-sidebar" data-v-a5aadcf6 data-v-d3283ff2><div class="vp-doc-container has-sidebar has-aside" data-v-d3283ff2 data-v-c2acd915><!--[--><!--]--><div class="container" data-v-c2acd915><div class="aside" vp-outline data-v-c2acd915><div class="aside-curtain" data-v-c2acd915></div><div class="aside-container" data-v-c2acd915><div class="aside-content" data-v-c2acd915><div class="vp-doc-aside" data-v-c2acd915 data-v-8e9ccc00><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="vp-doc-aside-outline" role="navigation" data-v-8e9ccc00 data-v-c71a8a7e><div class="content" data-v-c71a8a7e><div class="outline-marker" data-v-c71a8a7e></div><div id="doc-outline-aria-label" aria-level="2" class="outline-title" role="heading" data-v-c71a8a7e><span data-v-c71a8a7e>On this page</span><span class="vpi-print icon" data-v-c71a8a7e></span></div><ul class="root" data-v-c71a8a7e data-v-875470cb><!--[--><!--]--></ul></div></nav><!--[--><!--[--><!--[--><!--[--><div class="aside-nav-wrapper" data-v-a5aadcf6 data-v-44a708ba><a class="vp-link link no-icon vp-external-link-icon link" href="https://github.com/pengzhanbo/vuepress-theme-plume" target="_blank" rel="noopener noreferrer" data-v-44a708ba><!--[--><span class="vp-icon vpi-tabler-star" style="" aria-hidden data-provider="iconify" data-v-44a708ba></span><span class="link-text" data-v-44a708ba>Star on GitHub</span><span class="vpi-arrow-right" data-v-44a708ba></span><!--]--><!--[--><!--]--><!----></a><a class="vp-link link no-icon vp-external-link-icon link" href="https://github.com/pengzhanbo/vuepress-theme-plume/issues/new/choose" target="_blank" rel="noopener noreferrer" data-v-44a708ba><!--[--><span class="vp-icon vpi-octicon-issue-opened-16" style="" aria-hidden data-provider="iconify" data-v-44a708ba></span><span class="link-text" data-v-44a708ba>Create Issues</span><span class="vpi-arrow-right" data-v-44a708ba></span><!--]--><!--[--><!--]--><!----></a><a class="vp-link link link" href="/sponsor/" data-v-44a708ba><!--[--><span class="vp-icon vpi-ep-milk-tea" style="" aria-hidden data-provider="iconify" data-v-44a708ba></span><span class="link-text" data-v-44a708ba>Buy me a Bubble Tea</span><span class="vpi-arrow-right" data-v-44a708ba></span><!--]--><!--[--><!--]--><!----></a></div><!--]--><!--]--><!--]--><!--]--><div class="spacer" data-v-8e9ccc00></div><!--[--><!--]--></div></div></div></div><div class="content" data-v-c2acd915><div class="content-container" data-v-c2acd915><!--[--><!--]--><main class="main" data-v-c2acd915><nav class="vp-breadcrumb" data-v-c2acd915 data-v-68dbda29><ol vocab="https://schema.org/" typeof="BreadcrumbList" data-v-68dbda29><!--[--><li property="itemListElement" typeof="ListItem" data-v-68dbda29><a class="vp-link link no-icon breadcrumb" href="/en/" property="item" typeof="WebPage" data-v-68dbda29><!--[-->Home<!--]--><!--[--><!--]--><!----></a><span class="vpi-chevron-right" data-v-68dbda29></span><meta property="name" content="Home" data-v-68dbda29><meta property="position" content="1" data-v-68dbda29></li><li property="itemListElement" typeof="ListItem" data-v-68dbda29><span class="vp-link no-icon breadcrumb" property="item" typeof="WebPage" data-v-68dbda29><!--[-->Guide<!--]--><!--[--><!--]--><!----></span><span class="vpi-chevron-right" data-v-68dbda29></span><meta property="name" content="Guide" data-v-68dbda29><meta property="position" content="2" data-v-68dbda29></li><li property="itemListElement" typeof="ListItem" data-v-68dbda29><span class="vp-link no-icon breadcrumb" property="item" typeof="WebPage" data-v-68dbda29><!--[-->markdown<!--]--><!--[--><!--]--><!----></span><span class="vpi-chevron-right" data-v-68dbda29></span><meta property="name" content="markdown" data-v-68dbda29><meta property="position" content="3" data-v-68dbda29></li><li property="itemListElement" typeof="ListItem" data-v-68dbda29><a class="vp-link link no-icon breadcrumb current" href="/en/guide/markdown/basic/" property="item" typeof="WebPage" data-v-68dbda29><!--[-->Basic<!--]--><!--[--><!--]--><!----></a><!----><meta property="name" content="Basic" data-v-68dbda29><meta property="position" content="4" data-v-68dbda29></li><!--]--></ol></nav><!--[--><!--]--><!--[--><div class="vp-doc-title" data-v-42fa9e7c><!--[--><!--]--><h1 class="page-title" data-v-42fa9e7c><!----> Basic <!----></h1><!--[--><!--[--><!--[--><!--[--><div class="vp-page-context-menu" data-v-a5aadcf6 data-v-b0188d12><div class="page-context-button" type="button" data-v-b0188d12><span class="page-context-copy" data-v-b0188d12><span class="vpi-copy" data-v-b0188d12></span><span class="text" data-v-b0188d12>Copy page</span></span><span class="page-context-toggle" data-v-b0188d12><span class="vpi-chevron-down" data-v-b0188d12></span></span></div><ul class="page-context-menu" style="display:none;" data-v-b0188d12><li data-v-b0188d12><a href="javascript:void(0)" data-v-b0188d12><span class="vpi-copy" data-v-b0188d12></span><span data-v-b0188d12>Copy page <small data-v-b0188d12>Copy page as Markdown for LLMs</small></span></a></li><!--[--><li data-v-b0188d12><a href="/en/guide/markdown/basic/index.md" target="_blank" rel="noopener noreferrer" aria-label="View as Markdown" type="text/markdown" data-allow-mismatch data-v-b0188d12><span class="vpi-markdown" data-v-b0188d12></span><span data-v-b0188d12>View as Markdown <span class="vpi-external-link" data-v-b0188d12></span><small data-v-b0188d12>View this page as plain text</small></span></a></li><li data-v-b0188d12><a href="https://chat.openai.com/?prompt=" target="_blank" rel="noopener noreferrer" aria-label="Open in ChatGPT" data-allow-mismatch data-v-b0188d12><span class="vpi-chatgpt" data-v-b0188d12></span><span data-v-b0188d12>Open in ChatGPT <span class="vpi-external-link" data-v-b0188d12></span><small data-v-b0188d12>Ask ChatGPT about this page</small></span></a></li><li data-v-b0188d12><a href="https://claude.ai/new?q=" target="_blank" rel="noopener noreferrer" aria-label="Open in Claude" data-allow-mismatch data-v-b0188d12><span class="vpi-claude" data-v-b0188d12></span><span data-v-b0188d12>Open in Claude <span class="vpi-external-link" data-v-b0188d12></span><small data-v-b0188d12>Ask Claude about this page</small></span></a></li><li data-v-b0188d12><a href="https://perplexity.ai/?q=" target="_blank" rel="noopener noreferrer" aria-label="Open in Perplexity" data-allow-mismatch data-v-b0188d12><span class="vpi-perplexity" data-v-b0188d12></span><span data-v-b0188d12>Open in Perplexity <span class="vpi-external-link" data-v-b0188d12></span><small data-v-b0188d12>Ask Perplexity about this page</small></span></a></li><!--]--></ul></div><!--]--><!--]--><!--]--><!--]--></div><div class="vp-doc-meta" data-v-42fa9e7c><!--[--><!--]--><p class="reading-time" data-v-42fa9e7c><span class="vpi-books icon" data-v-42fa9e7c></span><span data-v-42fa9e7c>About 3434 words</span><span data-v-42fa9e7c>About 11 min</span></p><p data-v-42fa9e7c><span class="vpi-tag icon" data-v-42fa9e7c></span><!--[--><span class="vp-link tag vp-tag-bmrk" data-v-42fa9e7c><!--[-->Guide<!--]--><!--[--><!--]--><!----></span><span class="vp-link tag vp-tag-30up" data-v-42fa9e7c><!--[-->markdown<!--]--><!--[--><!--]--><!----></span><!--]--></p><!--[--><!--]--><p class="create-time" data-v-42fa9e7c><span class="vpi-clock icon" data-v-42fa9e7c></span><span data-v-42fa9e7c>2025-03-03</span></p></div><!--]--><!--[--><!--]--><!--[--><div class="_en_guide_markdown_basic_ external-link-icon-enabled vp-doc plume-content" vp-content data-v-c2acd915><!--[--><!--]--><div data-v-c2acd915><div class="hint-container note"><p class="hint-container-title">This document is forked from <a href="https://theme-hope.vuejs.press/zh/cookbook/markdown/" target="_blank" rel="noopener noreferrer">vuepress-theme-hope</a>, following the <a href="https://github.com/vuepress-theme-hope/vuepress-theme-hope/blob/main/LICENSE" target="_blank" rel="noopener noreferrer">MIT</a> license.</p></div><p>Markdown is a markup language that can be written using a plain text editor. Through simple syntax, it allows regular text content to have formatting capabilities.</p><p>The goal of Markdown is to achieve「readability and writability」.</p><h2 id="overview" tabindex="-1"><a class="header-anchor" href="#overview"><span>Overview</span></a></h2><p>The most emphasized aspect is its readability. A document written in Markdown should be directly publishable as plain text, and should not appear to be composed of tags or formatting instructions. Markdown syntax is influenced by several existing text-to-HTML formats, including <a href="http://docutils.sourceforge.net/mirror/setext.html" target="_blank" rel="noopener noreferrer">Setext</a>, <a href="http://www.aaronsw.com/2002/atx/" target="_blank" rel="noopener noreferrer">atx</a>, <a href="http://textism.com/tools/textile/" target="_blank" rel="noopener noreferrer">Textile</a>, <a href="http://docutils.sourceforge.net/rst.html" target="_blank" rel="noopener noreferrer">reStructuredText</a>, <a href="http://www.triptico.com/software/grutatxt.html" target="_blank" rel="noopener noreferrer">Grutatxt</a>, and <a href="http://ettext.taint.org/doc/" target="_blank" rel="noopener noreferrer">EtText</a>, with the primary inspiration coming from plain text email formatting.</p><p>Thus, Markdown syntax consists entirely of punctuation marks, carefully selected to visually represent their meaning. For example, adding asterisks around text looks like *emphasis*. Markdown lists look like lists. If you&#39;ve used email, blockquotes resemble quoted text.</p><p>Markdown has various derivatives to extend its functionality (e.g., tables, footnotes, embedded HTML), features not originally available in basic Markdown. These enable conversion to formats like LaTeX, Docbook. Notable enhanced versions include Markdown Extra, MultiMarkdown, and Maruku. These derivatives are either tool-based (e.g., Pandoc) or website-based (e.g., GitHub, Wikipedia), maintaining basic syntax compatibility but modifying rendering effects.</p><h2 id="usage" tabindex="-1"><a class="header-anchor" href="#usage"><span>Usage</span></a></h2><p>Markdown&#39;s syntax has a primary purpose: to serve as a writing language for web content. Markdown focuses on making documents easier to read and write, thus its syntax only covers what plain text can represent.</p><p>Markdown&#39;s syntax is simple, easy to learn, and more powerful than plain text, making it popular for blogging. WordPress, the world&#39;s most popular blogging platform, supports Markdown well.</p><p>It&#39;s used for documentation, typically saved as <code>README.md</code> in software directories.</p><p>Additionally, Markdown can quickly convert to presentation slides, Word documents, LaTeX papers, or even minimal viable prototypes with minimal code. In data science, Markdown has become essential for dynamic reproducible research.</p><h3 id="inline-html" tabindex="-1"><a class="header-anchor" href="#inline-html"><span>Inline HTML</span></a></h3><p>Any HTML tags not covered by Markdown can be directly written in the document. No special annotation is needed; simply include the tags.</p><p>Block-level elements like <code>&lt;div&gt;</code>, <code>&lt;table&gt;</code>, <code>&lt;pre&gt;</code>, and <code>&lt;p&gt;</code> must be separated by blank lines. These tags cannot be indented with tabs or spaces. Markdown&#39;s parser intelligently avoids adding unnecessary <code>&lt;p&gt;</code> tags around block elements.</p><p>For example, adding an HTML table in a Markdown file:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is a regular paragraph.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">table</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">tr</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">td</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Foo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">td</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">tr</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">table</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is another regular paragraph.</span></span></code></pre></div><p>Note that Markdown syntax is not processed within HTML blocks. For instance, you cannot use <code>*emphasis*</code> inside HTML blocks.</p><h3 id="special-character-auto-conversion" tabindex="-1"><a class="header-anchor" href="#special-character-auto-conversion"><span>Special Character Auto-Conversion</span></a></h3><p>In HTML files, two characters require special handling: <code>&lt;</code> and <code>&amp;</code>. The <code>&lt;</code> character starts a tag, and <code>&amp;</code> marks an HTML entity. If you want to use these characters literally, you must use their entity forms, like <code>&amp;lt;</code> and <code>&amp;amp;</code>.</p><p>The <code>&amp;</code> character can be problematic for those writing web documents. If you want to write &quot;AT&amp;T,&quot; you must write &quot;AT&amp;T.&quot; You also need to escape the <code>&amp;</code> in URLs. For example, if you want to link to <code>http://images.google.com/images?num=30&amp;q=larry+bird</code></p><p>you must convert the URL to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">http://images.google.com/images?num=30</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">amp</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">q=larry+bird</span></span></code></pre></div><p>to place it in the <code>href</code> attribute of a link tag. It&#39;s easy to forget this, and it might be the most common error detected by HTML validators.</p><p>Markdown allows you to use these characters directly, but you need to be careful with escape characters. If you use <code>&amp;</code> in an HTML entity, it won&#39;t be converted. In other cases, it will be converted to <code>&amp;amp;</code>. So, if you want to insert a copyright symbol in your text, you can write:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">copy</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span></span></code></pre></div><p>Markdown will not modify this text. However, if you write:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">AT&amp;T</span></span></code></pre></div><p>Markdown will convert it to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">AT</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">amp</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">T</span></span></code></pre></div><p>Similar behavior occurs with the <code>&lt;</code> character. Since Markdown supports <a href="#inline-html">inline HTML</a>, if you use <code>&lt;</code> as an HTML tag, Markdown won&#39;t convert it. But if you write:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">4 &lt; 5</span></span></code></pre></div><p>Markdown will convert it to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">4 </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">lt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> 5</span></span></code></pre></div><p>Note that within code spans, whether inline or block, both <code>&lt;</code> and <code>&amp;</code> are always converted to HTML entities. This feature allows you to easily write HTML code in Markdown, as you don&#39;t have to convert all <code>&lt;</code> and <code>&amp;</code> in HTML syntax to HTML entities to write HTML code.</p><hr><h2 id="block-elements" tabindex="-1"><a class="header-anchor" href="#block-elements"><span>Block Elements</span></a></h2><h3 id="paragraphs-and-line-breaks" tabindex="-1"><a class="header-anchor" href="#paragraphs-and-line-breaks"><span>Paragraphs and Line Breaks</span></a></h3><p>A paragraph is composed of one or more connected lines, and one or more blank lines separate different paragraphs. (A blank line is defined as a line that appears empty; for example, a line with only spaces and tabs is also considered a blank line.) Generally, paragraphs do not require indentation with spaces or tabs.</p><p>The phrase &quot;composed of one or more connected lines&quot; implies that Markdown allows forced line breaks within paragraphs. This differs from other text-to-HTML formats (including MovableType&#39;s &quot;Convert Line Breaks&quot; option), which convert every line break into a <code>&lt;br /&gt;</code> tag.</p><p>If you really want to insert a <code>&lt;br /&gt;</code> tag, add two or more spaces (<code></code>) or a slash (<code>/</code>) at the end of the line, then press Enter.</p><p>Yes, this requires more effort to insert a <code>&lt;br /&gt;</code>, but the method of converting every line break to <code>&lt;br /&gt;</code> is not suitable for Markdown. In Markdown, email-style <a href="#blockquotes">block quotes</a> and multi-paragraph <a href="#lists">lists</a> are more usable and readable when using line breaks for formatting.</p><h3 id="headings" tabindex="-1"><a class="header-anchor" href="#headings"><span>Headings</span></a></h3><p>Headings indicate the structure of an article.</p><p>Markdown supports two heading syntax styles: <a href="http://docutils.sourceforge.net/mirror/setext.html" target="_blank" rel="noopener noreferrer">Setext</a> and <a href="http://www.aaronsw.com/2002/atx/" target="_blank" rel="noopener noreferrer">atx</a>.</p><p>The Setext style uses underlines with <code>=</code> (for first-level headings) and <code>-</code> (for second-level headings), like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;">#</span><span style="--shiki-light:#1C6B48;--shiki-light-font-weight:bold;--shiki-dark:#4D9375;--shiki-dark-font-weight:bold;"> This is an H1</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;">##</span><span style="--shiki-light:#1C6B48;--shiki-light-font-weight:bold;--shiki-dark:#4D9375;--shiki-dark-font-weight:bold;"> This is an H2</span></span></code></pre></div><p>Any number of <code>=</code> or <code>-</code> characters can be used.</p><p>The Atx style (recommended) involves placing 1 to 6 <code>#</code> characters at the beginning of a line, corresponding to heading levels 1 to 6, like:</p><ul><li>H1: <code># Header 1</code></li><li>H2: <code>## Header 2</code></li><li>H3: <code>### Header 3</code></li><li>H4: <code>#### Header 4</code></li><li>H5: <code>##### Header 5</code></li><li>H6: <code>###### Header 6</code></li></ul><h3 id="blockquotes" tabindex="-1"><a class="header-anchor" href="#blockquotes"><span>Blockquotes</span></a></h3><p>Markdown uses email-style block quotes. If you&#39;re familiar with quoting in emails, you&#39;ll know how to create a block quote in a Markdown file. It looks like a forced line break with <code>&gt;</code> at the beginning of each line:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> id sem consectetuer libero luctus adipiscing.</span></span></code></pre></div><p>Markdown also allows you to place <code>&gt;</code> only at the beginning of the first line of a paragraph:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> id sem consectetuer libero luctus adipiscing.</span></span></code></pre></div><p>Block quotes can have levels (e.g., quotes within quotes) by adding more <code>&gt;</code> characters according to the level:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is the first level of quoting.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is nested blockquote.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> Back to the first level.</span></span></code></pre></div><p>Other Markdown syntax, including headings, lists, and code blocks, can be used within block quotes:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;"> ##</span><span style="--shiki-light:#1C6B48;--shiki-light-font-weight:bold;--shiki-dark:#4D9375;--shiki-dark-font-weight:bold;"> This is a header.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;"> 1.</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is the first list item.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;"> 1.</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is the second list item.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> Here&#39;s some example code:</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#1C6B48;--shiki-dark:#4D9375;"> return shell_exec(&quot;echo $input | $markdown_script&quot;);</span></span></code></pre></div><p>Any standard text editor can easily create email-style quotes. For example, in BBEdit, you can select text and choose &quot;Increase Quote Level&quot; from the menu.</p><h3 id="lists" tabindex="-1"><a class="header-anchor" href="#lists"><span>Lists</span></a></h3><p>Markdown supports ordered and unordered lists.</p><p>Unordered lists use hyphens as list markers (you can also use asterisks or plus signs):</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Red</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Green</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Blue</span></span></code></pre></div><p>You can also (though not recommended):</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Red</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Green</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Blue</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">*</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Red</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">*</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Green</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">*</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Blue</span></span></code></pre></div><p>Ordered lists use numbers followed by a period:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">1.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Bird</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">2.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> McHale</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">3.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Parish</span></span></code></pre></div><p>Importantly, the numbers you use for list markers do not affect the HTML output. The HTML for the above list would be:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">ol</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Bird</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">McHale</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Parish</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">ol</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>If you write the list markers as:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">1.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Bird</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">1.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> McHale</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">1.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Parish</span></span></code></pre></div><p>You&#39;ll still get the same HTML output. The key point is that you can make the list numbers in the Markdown file match the output, or just use <code>1</code> and not worry about the numbering.</p><p>List markers are typically placed at the left margin but can be indented by up to three spaces, with at least one space or tab after the marker.</p><p>To make lists look neater, you can align the content with consistent indentation:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Lorem ipsum dolor sit amet, consectetuer adipiscing elit.</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> viverra nec, fringilla in, laoreet vitae, risus.</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Donec sit amet nisl. Aliquam semper ipsum sit amet velit.</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Suspendisse id sem consectetuer libero luctus adipiscing.</span></span></code></pre></div><p>However, if you&#39;re lazy, you don&#39;t have to:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Lorem ipsum dolor sit amet, consectetuer adipiscing elit.</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> viverra nec, fringilla in, laoreet vitae, risus.</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Donec sit amet nisl. Aliquam semper ipsum sit amet velit.</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Suspendisse id sem consectetuer libero luctus adipiscing.</span></span></code></pre></div><p>If list items are separated by blank lines, Markdown will wrap the item content in <code>&lt;p&gt;</code> tags. For example:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Bird</span></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Magic</span></span></code></pre></div><p>Would be converted to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">ul</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Bird</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Magic</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">ul</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>But this:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Bird</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Magic</span></span></code></pre></div><p>Would be converted to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">ul</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Bird</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Magic</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">li</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">ul</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>List items can contain multiple paragraphs, with each paragraph indented by 4 spaces or one tab:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">1.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> This is a list item with two paragraphs. Lorem ipsum dolor</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> sit amet, consectetuer adipiscing elit. Aliquam hendrerit</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> mi posuere lectus.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Vestibulum enim wisi, viverra nec, fringilla in, laoreet</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> vitae, risus. Donec sit amet nisl. Aliquam semper ipsum</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> sit amet velit.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">2.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Suspendisse id sem consectetuer libero luctus adipiscing.</span></span></code></pre></div><p>If every line is indented, it looks better, but again, if you&#39;re lazy, Markdown allows:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> This is a list item with two paragraphs.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> This is the second paragraph in the list item. You&#39;re</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> only required to indent the first line. Lorem ipsum dolor</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> sit amet, consectetuer adipiscing elit.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> Another item in the same list.</span></span></code></pre></div><p>To include a quote within a list item, the <code>&gt;</code> needs to be indented:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">-</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> A list item with a blockquote:</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> This is a blockquote</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &gt;</span><span style="--shiki-light:#2E808F;--shiki-dark:#5D99A9;"> inside a list item.</span></span></code></pre></div><p>Accidental lists can occur with syntax like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#D4976C;">1986.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> What a great season.</span></span></code></pre></div><p>To avoid this, place a backslash before the period:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">1986</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">\.</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> What a great season.</span></span></code></pre></div><h3 id="code-blocks" tabindex="-1"><a class="header-anchor" href="#code-blocks"><span>Code Blocks</span></a></h3><p>For code writing or raw code of markup languages, you often need preformatted code blocks that shouldn&#39;t be formatted like regular paragraphs but displayed as-is. Markdown wraps these code blocks with <code>&lt;pre&gt;</code> and <code>&lt;code&gt;</code> tags.</p><p>Creating a code block in Markdown is simple: indent every line with 4 spaces or one tab. For example:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is a normal paragraph:</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is a code block.</span></span></code></pre></div><p>Markdown converts this to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is a normal paragraph:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">pre</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is a code block.</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">pre</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>The indentation (4 spaces or one tab) is removed, so:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Here is an example of AppleScript:</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">tell application &quot;Foo&quot;</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">beep</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">end tell</span></span></code></pre></div><p>Becomes:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Here is an example of AppleScript:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">pre</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">tell application &quot;Foo&quot;</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> beep</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">end tell</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">pre</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>A code block continues until a line with no indentation (or the end of the file).</p><p>Within code blocks, <code>&lt;</code>, <code>&amp;</code>, and <code>&gt;</code> are automatically converted to HTML entities, making it easy to insert HTML code examples. Just copy, paste, and indent, and Markdown handles the rest. For example:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">```</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">html</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">div</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> class</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">footer</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">copy</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> 2004 Foo Corporation</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">div</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">```</span></span></code></pre></div><p>Is converted to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">pre</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">lt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">div class=&quot;footer&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">gt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">amp</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">copy; 2004 Foo Corporation</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">lt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">/div</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">gt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">pre</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>In code blocks, regular Markdown syntax isn&#39;t processed, so asterisks remain asterisks. This allows you to easily write about Markdown syntax.</p><p>If you want to include Markdown-formatted code libraries within a code block, you can nest them.</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">````</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">md</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">```</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">js</span></span>
<span class="line"><span style="--shiki-light:#AB5959;--shiki-dark:#CB7676;">const</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> =</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 1</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">```</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">````</span></span></code></pre></div><p>Renders as</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">```</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">js</span></span>
<span class="line"><span style="--shiki-light:#AB5959;--shiki-dark:#CB7676;">const</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> =</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 1</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">```</span></span></code></pre></div><h3 id="horizontal-rules" tabindex="-1"><a class="header-anchor" href="#horizontal-rules"><span>Horizontal Rules</span></a></h3><p>You can create a horizontal rule by placing three or more asterisks, hyphens, or underscores on a line. No other content should be on the line. You can also add spaces between the characters. Any of the following will create a horizontal rule:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">---(recommended) * * * *** ***** - - - ---------------------------------------</span></span></code></pre></div><h2 id="inline-elements" tabindex="-1"><a class="header-anchor" href="#inline-elements"><span>Inline Elements</span></a></h2><h3 id="links" tabindex="-1"><a class="header-anchor" href="#links"><span>Links</span></a></h3><p>Markdown supports two types of link syntax: <em>inline</em> and <em>reference</em>.</p><p>In both cases, link text is marked with <code>[square brackets]</code>.</p><p>For an inline link, immediately after the square brackets, add parentheses with the URL. You can also include a title in quotes, like:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is [an example](http://example.com/ &quot;Title&quot;) inline link. [This</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">link](http://example.net/ ) has no title attribute.</span></span></code></pre></div><p>This produces:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> This is </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://example.com/ </span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> title</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Title</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> an example</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> inline</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> link.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://example.net/ </span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This link</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> has no title attribute.</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>For linking to resources on the same host, you can use relative paths:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">See my </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">About</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">](</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">/about/</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">)</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> page for details.</span></span></code></pre></div><p>Reference-style links use another set of square brackets after the link text, with an identifier for the link:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">This is </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">an example</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">id</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> reference-style link.</span></span></code></pre></div><p>Then, define the link identifier anywhere in the document:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">id</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://example.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional Title Here&quot;</span></span></code></pre></div><p>The link definition consists of:</p><ul><li>Square brackets with the link ID</li><li>A colon</li><li>One or more spaces or a tab</li><li>The URL</li><li>An optional title in single quotes, double quotes, or parentheses</li></ul><p>These three link definitions are equivalent:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">foo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://example.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional Title Here&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">foo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://example.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional Title Here&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">foo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://example.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional Title Here&quot;</span></span></code></pre></div><p><strong>Note:</strong> A known issue is that Markdown.pl 1.0.1 ignores single-quoted link titles.</p><p>URLs in link definitions can be enclosed in square brackets:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">id</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://example.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional Title Here&quot;</span></span></code></pre></div><p>You can also place the title on a new line with indentation for better readability with long URLs:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">id</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://example.com/longish/path/to/resource/here</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional Title Here&quot;</span></span></code></pre></div><p>Link identifiers are case-insensitive and can include letters, numbers, spaces, and punctuation. These two links are the same:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">link text</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">link text</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span></span></code></pre></div><p>The <em>default link ID</em> feature allows you to omit the link ID, making it the same as the link text. To use this, add empty square brackets after the link text. For example:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][]</span></span></code></pre></div><p>Then define the link:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://google.com/</span></span></code></pre></div><p>Since link text can contain spaces, the simplified ID can also include multiple words:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Visit </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Daring Fireball</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> for more information.</span></span></code></pre></div><p>Then define the link:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">daring fireball</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://daringfireball.net/</span></span></code></pre></div><p>Link definitions can be placed anywhere in the document, either after the paragraph where the link appears or at the end like annotations.</p><p>Here&#39;s an example of reference-style links:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">I get 10 times more traffic from </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">1</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> than from</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Yahoo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">2</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> or </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">MSN</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">3</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">1</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://google.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Google&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">2</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://search.yahoo.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Yahoo Search&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">3</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://search.msn.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;MSN Search&quot;</span></span></code></pre></div><p>Using link names instead:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">I get 10 times more traffic from </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> than from</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Yahoo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> or </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">MSN</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][]</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">.</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://google.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Google&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">yahoo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://search.yahoo.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Yahoo Search&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">msn</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> http://search.msn.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;MSN Search&quot;</span></span></code></pre></div><p>Both methods produce the same HTML:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> I get 10 times more traffic from</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://google.com/ </span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> title</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Google</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> than from</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://search.yahoo.com/ </span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> title</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Yahoo Search</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Yahoo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> or </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://search.msn.com/ </span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> title</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">MSN Search</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">MSN</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>For comparison, here&#39;s the inline-style version of the same content:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">I get 10 times more traffic from </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Google</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">](</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">http://google.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Google&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">)</span></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">than from </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Yahoo</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">](</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">http://search.yahoo.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Yahoo Search&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">)</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> or</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">MSN</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">](</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">http://search.msn.com/</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;MSN Search&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">)</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">.</span></span></code></pre></div><p>Reference-style links are more readable. The reference-style version has 81 characters, while the inline-style version has 176, and pure HTML would have 234. In HTML, tags outnumber text.</p><p>Using Markdown&#39;s reference-style links makes the document resemble the final browser output, allowing you to keep markup details separate from the main text for uninterrupted reading.</p><h3 id="emphasis" tabindex="-1"><a class="header-anchor" href="#emphasis"><span>Emphasis</span></a></h3><p>Markdown uses asterisks (<code>*</code>) and underscores (<code>_</code>) to mark emphasis. Text surrounded by <code>*</code> or <code>_</code> is wrapped in <code>&lt;em&gt;</code>, while text surrounded by double <code>*</code> or <code>_</code> is wrapped in <code>&lt;strong&gt;</code>, like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;">**</span><span style="--shiki-light:#393A34;--shiki-light-font-weight:bold;--shiki-dark:#DBD7CAEE;--shiki-dark-font-weight:bold;">double asterisks</span><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;">**</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> (recommended)</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;">**</span><span style="--shiki-light:#393A34;--shiki-light-font-weight:bold;--shiki-dark:#DBD7CAEE;--shiki-dark-font-weight:bold;">double underscores</span><span style="--shiki-light:#999999;--shiki-light-font-weight:bold;--shiki-dark:#666666;--shiki-dark-font-weight:bold;">**</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> (recommended)</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-light-font-style:italic;--shiki-dark:#666666;--shiki-dark-font-style:italic;">_</span><span style="--shiki-light:#393A34;--shiki-light-font-style:italic;--shiki-dark:#DBD7CAEE;--shiki-dark-font-style:italic;">single asterisks</span><span style="--shiki-light:#999999;--shiki-light-font-style:italic;--shiki-dark:#666666;--shiki-dark-font-style:italic;">_</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-light-font-style:italic;--shiki-dark:#666666;--shiki-dark-font-style:italic;">_</span><span style="--shiki-light:#393A34;--shiki-light-font-style:italic;--shiki-dark:#DBD7CAEE;--shiki-dark-font-style:italic;">single underscores</span><span style="--shiki-light:#999999;--shiki-light-font-style:italic;--shiki-dark:#666666;--shiki-dark-font-style:italic;">_</span></span></code></pre></div><p>This converts to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">em</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">single asterisks</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">em</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">em</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">single underscores</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">em</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">strong</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">double asterisks</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">strong</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">strong</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">double underscores</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">strong</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>You can choose your preferred style, as long as you use the same character to open and close.</p><p>Emphasis can be added in the middle of words:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">un</span><span style="--shiki-light:#999999;--shiki-light-font-style:italic;--shiki-dark:#666666;--shiki-dark-font-style:italic;">*</span><span style="--shiki-light:#393A34;--shiki-light-font-style:italic;--shiki-dark:#DBD7CAEE;--shiki-dark-font-style:italic;">frigging</span><span style="--shiki-light:#999999;--shiki-light-font-style:italic;--shiki-dark:#666666;--shiki-dark-font-style:italic;">*</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">believable</span></span></code></pre></div><p>However, if <code>*</code> or <code>_</code> has spaces on both sides, it will be treated as regular text.</p><p>To insert literal asterisks or underscores, use a backslash:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">\*</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">this text is surrounded by literal asterisks</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">\*</span></span></code></pre></div><h3 id="code" tabindex="-1"><a class="header-anchor" href="#code"><span>Code</span></a></h3><p>To mark inline code, wrap it in backticks (<code>`</code>), like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Use the </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">printf()</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> function.</span></span></code></pre></div><p>This produces:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Use the </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">printf()</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> function.</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>To include a backtick within the code, use multiple backticks to open and close the inline code:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">``</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">There is a literal backtick (`) here.</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">``</span></span></code></pre></div><p>This renders as:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">There is a literal backtick (`) here.</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>You can add a space at the start or end of the code span to include a backtick at the beginning:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">A single backtick in a code span: </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">``</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> ` </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">``</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">A backtick-delimited string in a code span: </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">``</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> `foo` </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">``</span></span></code></pre></div><p>This results in:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">A single backtick in a code span: </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">`</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">A backtick-delimited string in a code span: </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">`foo`</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>Within code spans, <code>&amp;</code> and brackets are converted to HTML entities, making it easier to insert HTML code. Markdown converts:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Please don&#39;t use any </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">&lt;blink&gt;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> tags.</span></span></code></pre></div><p>To:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">Please don&#39;t use any </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">lt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">blink</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">gt</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> tags.</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>You can also write:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">&amp;#8212;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> is the decimal-encoded equivalent of </span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">&amp;mdash;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">`</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">.</span></span></code></pre></div><p>Which produces:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">amp</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">#8212;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;"> is the decimal-encoded equivalent of</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">amp</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">mdash;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">code</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">.</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">p</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><h3 id="images" tabindex="-1"><a class="header-anchor" href="#images"><span>Images</span></a></h3><p>Creating a natural syntax for inserting images in plain text is challenging.</p><p>Markdown uses a syntax similar to links for images, supporting both <em>inline</em> and <em>reference</em> styles.</p><p>The inline image syntax looks like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">![</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Alt text</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">](</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">/path/to/img.jpg</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">)</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">![</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Alt text</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">](</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">/path/to/img.jpg</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional title&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">)</span></span></code></pre></div><p>This consists of:</p><ul><li>An exclamation mark <code>!</code></li><li>Square brackets containing the image&#39;s alt text</li><li>Parentheses containing the image URL, optionally followed by a quoted title.</li></ul><p>Reference-style image syntax looks like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">![</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Alt text</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">][</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">id</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span></span></code></pre></div><p>Where <code>id</code> is the image reference name, defined like:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">[</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">id</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]:</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;"> url/to/image</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;"> &quot;Optional title attribute&quot;</span></span></code></pre></div><p>Currently, Markdown doesn&#39;t support specifying image width and height. For that, use the regular <code>&lt;img&gt;</code> tag.</p><h3 id="other-text-styles" tabindex="-1"><a class="header-anchor" href="#other-text-styles"><span>Other Text Styles</span></a></h3><ul><li>Delete: <code>~~delete~~</code></li><li>Paragraphs: Leave a blank line between paragraphs</li><li>Line breaks: Add two spaces at the end of a line</li></ul><hr><h2 id="other" tabindex="-1"><a class="header-anchor" href="#other"><span>Other</span></a></h2><h3 id="automatic-links" tabindex="-1"><a class="header-anchor" href="#automatic-links"><span>Automatic Links</span></a></h3><p>Markdown supports concise automatic link syntax for URLs and email addresses. Enclosing text in brackets automatically converts it to a link. For example:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#393A3490;--shiki-light-text-decoration:underline;--shiki-dark:#DEDCD590;--shiki-dark-text-decoration:underline;">http://example.com/</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>Markdown converts this to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://example.com/</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">http://example.com/</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>Automatic email links are similar, but Markdown encodes characters as hexadecimal HTML entities to confuse address-harvesting bots. For example:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">address@example.com</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>Markdown converts this to:</p><div class="language-html" data-highlighter="shiki" data-ext="html" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-html"><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span></span>
<span class="line"><span style="--shiki-light:#B07D48;--shiki-dark:#BD976A;"> href</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">=</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x6D;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x61;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">i</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x6C;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x74;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x6F;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x61;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x64;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x64;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x72;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x65;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#115;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#115;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#64;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#101;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#120;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x61;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#109;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x70;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x6C;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">e</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x2E;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#99;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#111;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#109;</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &gt;&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x61;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x64;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x64;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x72;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x65;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#115;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#115;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#64;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#101;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#120;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x61;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#109;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x70;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x6C;</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">e</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#x2E;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#99;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#111;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&amp;</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">#109;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">a</span></span>
<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><p>This creates a clickable <a href="mailto:address@example.com" target="_blank" rel="noopener noreferrer">address@example.com</a> link in the browser.</p><h3 id="escape-characters" tabindex="-1"><a class="header-anchor" href="#escape-characters"><span>Escape Characters</span></a></h3><p>Markdown uses backslashes to insert characters that have special meaning in its syntax. For example, to use asterisks for emphasis without <code>&lt;em&gt;</code> tags, precede them with a backslash:</p><div class="language-md" data-highlighter="shiki" data-ext="md" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;"><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code"><code class="language-md"><span class="line"><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">\*</span><span style="--shiki-light:#393A34;--shiki-dark:#DBD7CAEE;">literal asterisks</span><span style="--shiki-light:#A65E2B;--shiki-dark:#C99076;">\*</span></span></code></pre></div><p>Markdown supports escaping the following characters:</p><ul><li><code>\</code> backslash</li><li><code>`</code> backtick</li><li><code>*</code> asterisk</li><li><code>_</code> underscore</li><li><code>{}</code> curly braces</li><li><code>[]</code> square brackets</li><li><code>()</code> parentheses</li><li><code>#</code> hash</li><li><code>+</code> plus</li><li><code>-</code> minus</li><li><code>.</code> period</li><li><code>!</code> exclamation mark</li></ul><h2 id="keyboard-shortcuts" tabindex="-1"><a class="header-anchor" href="#keyboard-shortcuts"><span>Keyboard Shortcuts</span></a></h2><table><thead><tr><th>Rendered Effect</th><th>Markdown Syntax</th><th>Shortcut Key</th></tr></thead><tbody><tr><td><strong>Bold</strong></td><td><code>**text**</code></td><td>Ctrl/⌘ + B</td></tr><tr><td><em>Emphasize</em></td><td><code>*text*</code></td><td>Ctrl/⌘ + I</td></tr><tr><td><code>Inline Code</code></td><td>`code`</td><td>Select then <code>`</code></td></tr></tbody></table><h2 id="tables" tabindex="-1"><a class="header-anchor" href="#tables"><span>Tables</span></a></h2><table><thead><tr><th style="text-align:center;">Center</th><th style="text-align:right;">Right Aligned</th><th style="text-align:left;">Left Aligned</th></tr></thead><tbody><tr><td style="text-align:center;">Use <code>:-:</code></td><td style="text-align:right;">Use <code>-:</code></td><td style="text-align:left;">Use <code>:-</code></td></tr><tr><td style="text-align:center;">b</td><td style="text-align:right;">aaaaaaaaa</td><td style="text-align:left;">aaaa</td></tr><tr><td style="text-align:center;">c</td><td style="text-align:right;">aaaa</td><td style="text-align:left;">a</td></tr></tbody></table></div><!--[--><h2 id="doc-contributors" tabindex="-1"><a href="#doc-contributors" class="header-anchor"><span>Contributors</span></a></h2><div class="vp-contributors"><a href="https://github.com/zhenghaoyang24" target="_blank" rel="noreferrer" class="vp-contributor"><img src="https://avatars.githubusercontent.com/zhenghaoyang24?v=4" alt class="vp-contributor-avatar"><span class="vp-contributor-name">zhenghaoyang24</span></a><a href="https://github.com/pengzhanbo" target="_blank" rel="noreferrer" class="vp-contributor"><img src="https://avatars.githubusercontent.com/pengzhanbo?v=4" alt class="vp-contributor-avatar"><span class="vp-contributor-name">pengzhanbo</span></a></div><!--]--><!--[--><h2 id="doc-changelog" tabindex="-1"><a href="#doc-changelog" class="header-anchor"><span>Changelog</span></a></h2><div class="vp-changelog-wrapper"><div class="vp-changelog-header"><div class="vp-latest-updated"><span class="vp-changelog-icon"></span><span data-allow-mismatch>10/7/25, 3:13 PM</span></div><div><span class="vp-changelog-menu-icon"></span><span>View All Changelog</span></div></div><ul class="vp-changelog-list"><!--[--><li class="vp-changelog-item-commit"><a class="vp-changelog-hash" href="https://github.com/pengzhanbo/vuepress-theme-plume/commit/4d2361a7046214fe0f4e4af01831107fd00e38ad" target="_blank" rel="noreferrer"><code>4d236</code></a><span class="vp-changelog-divider">-</span><span class="vp-changelog-message">feat(theme)!: add collections support (<a href="https://github.com/pengzhanbo/vuepress-theme-plume/issues/704" target="_blank" rel="noopener noreferrer">#704</a>)</span><span class="vp-changelog-date" data-allow-mismatch>on <time datetime="2025-10-07T15:13:09.000Z">10/7/25</time></span></li><li class="vp-changelog-item-commit"><a class="vp-changelog-hash" href="https://github.com/pengzhanbo/vuepress-theme-plume/commit/9f99ae3ca72b3085c6cd383a9084f42be299c400" target="_blank" rel="noreferrer"><code>9f99a</code></a><span class="vp-changelog-divider">-</span><span class="vp-changelog-message">docs: add en <code>markdown</code> doc (<a href="https://github.com/pengzhanbo/vuepress-theme-plume/issues/538" target="_blank" rel="noopener noreferrer">#538</a>)</span><span class="vp-changelog-date" data-allow-mismatch>on <time datetime="2025-03-27T13:06:53.000Z">3/27/25</time></span></li><li class="vp-changelog-item-commit"><a class="vp-changelog-hash" href="https://github.com/pengzhanbo/vuepress-theme-plume/commit/0fd6cac57412002f4d72dc10378789b529adc357" target="_blank" rel="noreferrer"><code>0fd6c</code></a><span class="vp-changelog-divider">-</span><span class="vp-changelog-message">refactor(theme): improve types and flat config (<a href="https://github.com/pengzhanbo/vuepress-theme-plume/issues/524" target="_blank" rel="noopener noreferrer">#524</a>)</span><span class="vp-changelog-date" data-allow-mismatch>on <time datetime="2025-03-15T18:29:30.000Z">3/15/25</time></span></li><li class="vp-changelog-item-commit"><a class="vp-changelog-hash" href="https://github.com/pengzhanbo/vuepress-theme-plume/commit/a4ac3a30e0b74175b3cd4fd82c52b2321b013926" target="_blank" rel="noreferrer"><code>a4ac3</code></a><span class="vp-changelog-divider">-</span><span class="vp-changelog-message">docs: add en-US docs (<a href="https://github.com/pengzhanbo/vuepress-theme-plume/issues/514" target="_blank" rel="noopener noreferrer">#514</a>)</span><span class="vp-changelog-date" data-allow-mismatch>on <time datetime="2025-03-09T03:14:47.000Z">3/9/25</time></span></li><!--]--></ul></div><!--]--><!----><footer class="vp-doc-footer" data-v-c2acd915 data-v-393f5f4b><!--[--><!--]--><div class="edit-info" data-v-393f5f4b><div class="edit-link" data-v-393f5f4b><a class="vp-link link no-icon vp-external-link-icon edit-link-button" href="https://github.com/pengzhanbo/vuepress-theme-plume/edit/main/docs/en/guide/markdown/basic.md" target="_blank" rel="noopener noreferrer" data-v-393f5f4b><!--[--><span class="vpi-square-pen edit-link-icon" aria-label="edit icon" data-v-393f5f4b></span> Edit this page<!--]--><!--[--><!--]--><!----></a></div><!----></div><!----><nav class="prev-next" data-v-393f5f4b><div class="pager" data-v-393f5f4b><a class="vp-link link pager-link prev" href="/en/guide/optimize-build/" data-v-393f5f4b><!--[--><span class="desc" data-v-393f5f4b>Previous page</span><span class="title" data-v-393f5f4b><span class="vp-icon vpi-clarity-bundle-solid" style="" aria-hidden data-provider="iconify" data-v-393f5f4b></span><span data-v-393f5f4b>Build Optimization</span></span><!--]--><!--[--><!--]--><!----></a></div><div class="pager" data-v-393f5f4b><a class="vp-link link pager-link next" href="/en/guide/markdown/extensions/" data-v-393f5f4b><!--[--><span class="desc" data-v-393f5f4b>Next page</span><span class="title" data-v-393f5f4b><span class="vp-icon vpi-fluent-mdl2-auto-enhance-on" style="" aria-hidden data-provider="iconify" data-v-393f5f4b></span><span data-v-393f5f4b>Extensions</span></span><!--]--><!--[--><!--]--><!----></a></div></nav></footer></div><!--]--></main><div id="comment" class="giscus-wrapper input-top vp-comment" vp-comment style="display:block;" data-v-c2acd915><div style="display: flex;align-items: center;justify-content: center;height: 96px"><span style="--loading-icon: url(&quot;data:image/svg+xml;charset=utf8,%3Csvg preserveAspectRatio=%22xMidYMid%22 viewBox=%2225 25 50 50%22%3E%3CanimateTransform attributeName=%22transform%22 type=%22rotate%22 dur=%222s%22 keyTimes=%220;1%22 repeatCount=%22indefinite%22 values=%220;360%22%3E%3C/animateTransform%3E%3Ccircle cx=%2250%22 cy=%2250%22 r=%2220%22 fill=%22none%22 stroke=%22currentColor%22 stroke-width=%224%22 stroke-linecap=%22round%22%3E%3Canimate attributeName=%22stroke-dasharray%22 dur=%221.5s%22 keyTimes=%220;0.5;1%22 repeatCount=%22indefinite%22 values=%221,200;90,200;1,200%22%3E%3C/animate%3E%3Canimate attributeName=%22stroke-dashoffset%22 dur=%221.5s%22 keyTimes=%220;0.5;1%22 repeatCount=%22indefinite%22 values=%220;-35px;-125px%22%3E%3C/animate%3E%3C/circle%3E%3C/svg%3E&quot;);--icon-size: 48px;display: inline-block;width: var(--icon-size);height: var(--icon-size);background-color: currentcolor;-webkit-mask-image: var(--loading-icon);mask-image: var(--loading-icon)"></span></div></div><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!--]--><button type="button" class="vp-back-to-top" aria-label="back to top" data-v-a5aadcf6 style="display:none;" data-v-7a6b3799><span class="percent" data-allow-mismatch data-v-7a6b3799>0%</span><span class="show icon vpi-back-to-top" data-v-7a6b3799></span><svg aria-hidden="true" data-v-7a6b3799><circle cx="50%" cy="50%" data-allow-mismatch style="stroke-dasharray:calc(0% - 12.566370614359172px) calc(314.1592653589793% - 12.566370614359172px);" data-v-7a6b3799></circle></svg></button><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" aria-label="sign down" class="vp-sign-down" aria-hidden="true" data-v-a5aadcf6 style="display:none;" data-v-43069080><g fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2.5" data-v-43069080><path d="m19 11l-7 6l-7-6" data-v-43069080></path><path d="m19 5l-7 6l-7-6" opacity="0.6" data-v-43069080></path></g></svg><footer class="vp-footer has-sidebar" vp-footer data-v-a5aadcf6 data-v-b83cc7e0><!--[--><div class="container" data-v-b83cc7e0><div class="message" data-v-b83cc7e0>Powered by <a target="_blank" href="https://v2.vuepress.vuejs.org/">VuePress</a> & <a target="_blank" href="https://theme-plume.vuejs.press">vuepress-theme-plume</a></div><div class="copyright" data-v-b83cc7e0>Copyright © 2021-present pengzhanbo</div></div><!--]--></footer><!--[--><!--]--><!--]--></div><!----><!--]--><!--[--><!--]--><!--]--></div><script type="module" src="/assets/app-B2DsuqVi.js" defer></script></body></html>
Reference in New Issue View Git Blame Copy Permalink