<meta name="description" content="包含实用示例和技巧的综合指南。附赠免费工具。"> <link rel="canonical" href="https://txt-tool.com/zh/blog/markdown-cheat-sheet.html"> <meta property="og:title" content="Markdown Cheat Sheet: Complete Reference Guide"> <meta property="og:description" content="Markdown Cheat Sheet: Complete Reference Guide. Free guide with examples."> <meta property="og:url" content="https://txt-tool.com/zh/blog/markdown-cheat-sheet.html"> <meta property="og:type" content="article"> <meta name="twitter:card" content="summary_large_image"> <link rel="stylesheet" href="/css/style.css?v=20260327c"> <script src="/js/theme.js"></script> <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-6478776854131333" crossorigin="anonymous"></script> <link rel="icon" type="image/svg+xml" href="/favicon.svg"> <script type="application/ld+json">{"@context": "https://schema.org", "@type": "BlogPosting", "headline": "Markdown Cheat Sheet", "datePublished": "2026-03-16", "dateModified":"2026-03-31", "author": {"@type": "Organization", "name": "TxtTool"}, "publisher": {"@type": "Organization", "name": "TxtTool"}, "description": "Markdown Cheat Sheet: Complete Reference Guide. Comprehensive guide with practical examples and tips. Free tools included.", "mainEntityOfPage": {"@type": "WebPage", "@id": "https://txt-tool.com/blog/markdown-cheat-sheet.html"}}</script> <script type="application/ld+json">{"@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{"@type": "ListItem", "position": 1, "name": "Home", "item": "https://txt-tool.com/"}, {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://txt-tool.com/blog/"}, {"@type": "ListItem", "position": 3, "name": "Markdown Cheat Sheet", "item": "https://txt-tool.com/blog/markdown-cheat-sheet.html"}]}</script> <link rel="alternate" hreflang="zh" href="https://txt-tool.com/zh/blog/markdown-cheat-sheet.html"> <link rel="alternate" hreflang="en" href="https://txt-tool.com/blog/markdown-cheat-sheet.html"> <script async src="https://www.googletagmanager.com/gtag/js?id=G-CZ7GQC3DKR"></script><script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag("js",new Date());gtag("config","G-CZ7GQC3DKR",{"linker":{"domains":["conv-kit.com,go-calc.com,gen-kit.com,run-dev.com,seo-io.com,txt-tool.com,img-kit.com,the-pdf.com,dl-kit.com,nettool1.com"]}});</script></head> <body> <header class="site-header"> <div class="container header-inner"> <a href="/" class="logo"> <svg viewBox="0 0 28 28" width="28" height="28" fill="none" xmlns="http://www.w3.org/2000/svg"> <rect width="28" height="28" rx="6" fill="#06b6d4"/> <path d="M7 7h14M7 12h10M7 17h6" stroke="#fff" stroke-width="2" stroke-linecap="round"/> </svg> Txt<span class="logo-accent">Tool</span> </a> <button class="mobile-menu-btn" aria-label="Toggle menu" onclick="document.querySelector('.nav-links').classList.toggle('open')">☰</button> <nav class="nav-links" aria-label="Main navigation"> <a href="/" class="active">Home</a> <a href="/alltools/">Tools</a> <a href="/blog/">Blog</a> <a href="/about.html">About</a> </nav> <div class="header-actions"> <div class="lang-dropdown"> <button class="lang-btn" onclick="this.nextElementSibling.classList.toggle('show')" aria-label="Language"> <span>🇺🇸</span> EN <svg width="12" height="12" viewBox="0 0 12 12" fill="none"><path d="M3 5l3 3 3-3" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg> </button> <div class="lang-menu" id="langMenu"> <a href="/">🇺🇸 English</a> <a href="/es/">🇪🇸 Español</a> <a href="/fr/">🇫🇷 Français</a> <a href="/de/">🇩🇪 Deutsch</a> <a href="/ja/">🇯🇵 日本語</a> <a href="/pt/">🇧🇷 Português</a> <a href="/zh/">🇨🇳 中文</a> <a href="/ko/">🇰🇷 한국어</a> </div> </div> <button class="theme-toggle" id="themeToggle" onclick="toggleTheme()" title="Toggle theme"> <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="12" cy="12" r="5"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg> </button> </div> </div> </header> <nav class="breadcrumb" aria-label="Breadcrumb"><div class="container"><a href="/">TxtTool</a><span class="sep">/</span><a href="/blog/">Blog</a><span class="sep">/</span><span>Markdown Cheat Sheet: Complete Reference Guide</span></div></nav> <main id="main-content"> <article class="container" style="max-width:800px;margin:2rem auto;padding:0 1rem"><h1>Markdown 速查表：完整参考指南</h1> <p class="text-muted" style="margin-bottom:1.5rem"><time datetime="2026-03-31">2026年3月31日</time> · 12分钟阅读</p> <p>Markdown 已成为网络上文本格式化的通用语言。无论你是在 GitHub 上编写文档、在 Reddit 上发帖、在 Discord 上聊天、在 Notion 中整理笔记，还是为无数其他平台创建内容，Markdown 无处不在。学习这种简单而强大的语法将使你在使用的每个数字工作空间中更加高效。</p> <p>本综合指南涵盖了从基本格式到高级技巧的所有内容，包含实用示例和真实用例。将此页面加入书签，作为你所有 Markdown 相关内容的首选参考。</p> <details open style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"> <summary style="cursor:pointer;font-weight:600;margin-bottom:0.75rem">📑 目录</summary> <ul style="margin:0;padding-left:1.5rem"> <li><a href="#what-is-markdown">什么是 Markdown 以及为什么使用它?</a></li> <li><a href="#basic-formatting">基本文本格式</a></li> <li><a href="#headings">标题和文档结构</a></li> <li><a href="#lists">列表：有序、无序和嵌套</a></li> <li><a href="#links-images">链接和图片</a></li> <li><a href="#code-blocks">代码块和语法高亮</a></li> <li><a href="#tables">创建表格</a></li> <li><a href="#blockquotes">引用和引文</a></li> <li><a href="#advanced-features">高级 Markdown 功能</a></li> <li><a href="#flavors">Markdown 变体和扩展</a></li> <li><a href="#best-practices">最佳实践和常见错误</a></li> <li><a href="#faq">常见问题</a></li> </ul> </details> <h2 id="what-is-markdown">什么是 Markdown 以及为什么使用它?</h2> <p>Markdown 是 John Gruber 于 2004 年创建的一种轻量级标记语言。它的理念很简单：纯文本应该原样可读，但也可以转换为 HTML 和其他格式。与隐藏按钮和菜单后面格式的富文本编辑器不同，Markdown 保持一切可见和可移植。</p> <p>Markdown 的美妙之处在于其简单性。你可以在任何文本编辑器中编写它，使用 Git 进行版本控制，并将其转换为 HTML、PDF 或数十种其他格式。它已成为技术文档、README 文件、博客文章和协作写作的事实标准。</p> <p><strong>Markdown 的使用场景：</strong></p> <ul> <li>GitHub、GitLab 和 Bitbucket 用于 README 文件和文档</li> <li>Reddit、Discord 和 Slack 用于格式化消息</li> <li>Notion、Obsidian 和 Roam Research 用于笔记</li> <li>静态站点生成器如 Jekyll、Hugo 和 Gatsby</li> <li>内容管理系统和博客平台</li> <li>技术写作工具和文档平台</li> </ul> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>专业提示：</strong>使用我们的免费 <a href="/tools/markdown-editor/">Markdown 编辑器</a> 实时练习语法并实时预览。这是边做边学的最快方式。</p></div> <h2 id="basic-formatting">基本文本格式</h2> <p>Markdown 的基本格式语法直观且易于记忆。大多数格式使用围绕要设置样式的文本的特殊字符。</p> <h3>粗体文本</h3> <p>通过用双星号或双下划线包裹单词来创建粗体文本：</p> <pre><code>**此文本为粗体** __这也是粗体__</code></pre> <p>两者都产生：<strong>此文本为粗体</strong></p> <h3>斜体文本</h3> <p>使用单星号或单下划线表示斜体文本：</p> <pre><code>*此文本为斜体* _这也是斜体_</code></pre> <p>两者都产生：<em>此文本为斜体</em></p> <h3>粗体和斜体组合</h3> <p>通过使用三个星号或混合星号和下划线来组合两者：</p> <pre><code>***粗体和斜体文本*** **_也是粗体和斜体_**</code></pre> <p>结果：<strong><em>粗体和斜体文本</em></strong></p> <h3>删除线</h3> <p>大多数 Markdown 变体支持使用双波浪号的删除线：</p> <pre><code>~~此文本被划掉~~</code></pre> <p>结果：<del>此文本被划掉</del></p> <h3>行内代码</h3> <p>将文本包裹在单反引号中以将其格式化为行内代码：</p> <pre><code>使用 `console.log()` 函数进行调试。</code></pre> <p>结果：使用 <code>console.log()</code> 函数进行调试。</p> <table style="width:100%;border-collapse:collapse;margin:1.5rem 0"> <thead> <tr style="background:var(--bg-secondary)"> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">语法</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">输出</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">用例</th> </tr> </thead> <tbody> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>**text**</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><strong>text</strong></td> <td style="border:1px solid var(--border);padding:0.75rem">强调、重要术语</td> </tr> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>*text*</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><em>text</em></td> <td style="border:1px solid var(--border);padding:0.75rem">微妙强调、书名</td> </tr> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>~~text~~</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><del>text</del></td> <td style="border:1px solid var(--border);padding:0.75rem">删除的内容、更正</td> </tr> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>`text`</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><code>text</code></td> <td style="border:1px solid var(--border);padding:0.75rem">代码、命令、文件名</td> </tr> </tbody> </table> <h2 id="headings">标题和文档结构</h2> <p>标题创建文档层次结构并提高可读性。Markdown 支持六级标题，对应 HTML 的 <code><h1></code> 到 <code><h6></code> 标签。</p> <pre><code># 标题 1（最大） ## 标题 2 ### 标题 3 #### 标题 4 ##### 标题 5 ###### 标题 6（最小）</code></pre> <p>井号的数量决定标题级别。始终在井号和标题文本之间包含一个空格。</p> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>最佳实践：</strong>按层次使用标题级别。不要从 H1 跳到 H4。这可以改善屏幕阅读器的可访问性，并帮助搜索引擎理解你的内容结构。</p></div> <h3>替代标题语法</h3> <p>对于 H1 和 H2，你也可以使用下划线样式语法：</p> <pre><code>标题 1 ========= 标题 2 ---------</code></pre> <p>但是，井号语法更常见并支持所有六个级别。</p> <h3>标题最佳实践</h3> <ul> <li>每个文档只使用一个 H1（通常是标题）</li> <li>保持标题简洁和描述性</li> <li>一致使用句子大小写或标题大小写</li> <li>不要以标点符号结束标题</li> <li>在标题前后添加空行以提高可读性</li> </ul> <h2 id="lists">列表：有序、无序和嵌套</h2> <p>列表是组织信息的基础。Markdown 支持无序（项目符号）列表、有序（编号）列表以及两者的嵌套组合。</p> <h3>无序列表</h3> <p>使用星号、连字符或加号创建项目符号列表。三者产生相同的输出：</p> <pre><code>* 第一项 * 第二项 * 第三项 - 第一项 - 第二项 - 第三项 + 第一项 + 第二项 + 第三项</code></pre> <p>选择一种样式并在整个文档中保持一致。</p> <h3>有序列表</h3> <p>用句点为列表项编号。实际数字无关紧要——Markdown 会自动重新编号：</p> <pre><code>1. 第一项 2. 第二项 3. 第三项 1. 第一项 1. 第二项 1. 第三项</code></pre> <p>两者产生相同的编号列表。使用全部 1 可以更容易地重新排序项目而无需重新编号。</p> <h3>嵌套列表</h3> <p>用 2 或 4 个空格缩进嵌套项（保持一致）：</p> <pre><code>1. 第一项 - 嵌套项目符号 - 另一个嵌套项目符号 2. 第二项 1. 嵌套编号 2. 另一个嵌套编号</code></pre> <h3>任务列表</h3> <p>许多 Markdown 变体支持带复选框的任务列表：</p> <pre><code>- [x] 已完成任务 - [ ] 未完成任务 - [ ] 另一个未完成任务</code></pre> <p>这在 GitHub 问题和项目管理工具中特别有用。</p> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>快速提示：</strong>编写多段落列表项时，缩进后续段落以与文本的第一行对齐，而不是与项目符号对齐。</p></div> <h2 id="links-images">链接和图片</h2> <p>Markdown 使添加超链接和图片变得容易，而不会用 HTML 标签弄乱你的文本。</p> <h3>基本链接</h3> <p>链接的语法很简单：方括号表示链接文本，后跟括号表示 URL：</p> <pre><code>[访问我们的 Markdown 编辑器](/tools/markdown-editor/)</code></pre> <p>结果：<a href="/tools/markdown-editor/">访问我们的 Markdown 编辑器</a></p> <h3>带标题的链接</h3> <p>通过在 URL 后用引号包含标题属性（悬停时显示）来添加标题属性：</p> <pre><code>[GitHub](https://github.com "访问 GitHub")</code></pre> <h3>引用样式链接</h3> <p>对于有许多重复链接的文档，使用引用样式语法保持文本整洁：</p> <pre><code>查看 [Google][1] 和 [GitHub][2] 了解更多信息。 [1]: https://google.com "Google" [2]: https://github.com "GitHub"</code></pre> <p>引用定义可以出现在文档的任何位置，并且在输出中不可见。</p> <h3>自动链接</h3> <p>将 URL 或电子邮件地址包裹在尖括号中使其可点击：</p> <pre><code><https://example.com> <email@example.com></code></pre> <p>许多 Markdown 处理器也会自动链接不带尖括号的裸 URL。</p> <h3>图片</h3> <p>图片语法与链接相同，但带有感叹号前缀：</p> <pre><code>![描述图片的替代文本](image-url.png) ![替代文本](image-url.png "可选标题")</code></pre> <p>替代文本对于可访问性和 SEO 至关重要。始终提供描述性的替代文本来解释图片显示的内容。</p> <h3>图片最佳实践</h3> <ul> <li>为可访问性编写描述性替代文本</li> <li>对同一存储库中的图片使用相对路径</li> <li>优化图片文件大小以加快加载速度</li> <li>考虑对重复图片使用引用样式语法</li> <li>测试图片在目标平台上是否正确显示</li> </ul> <h2 id="code-blocks">代码块和语法高亮</h2> <p>代码块对于技术文档至关重要。Markdown 提供多种格式化代码的方式，从行内片段到带语法高亮的多行块。</p> <h3>行内代码</h3> <p>如前所述，将行内代码包裹在单反引号中：</p> <pre><code>使用 `git commit` 命令保存更改。</code></pre> <h3>围栏代码块</h3> <p>对于多行代码，在代码前后使用三个反引号（或三个波浪号）：</p> <pre><code>``` function greet(name) { return `Hello, ${name}!`; } ```</code></pre> <h3>语法高亮</h3> <p>在开头反引号后指定编程语言以进行语法高亮：</p> <pre><code>```javascript function greet(name) { return `Hello, ${name}!`; } ``` ```python def greet(name): return f"Hello, {name}!" ``` ```css .button { background-color: #06b6d4; border-radius: 8px; } ```</code></pre> <p>大多数 Markdown 处理器支持数十种语言，包括 JavaScript、Python、Java、C++、Ruby、Go、Rust、SQL、HTML、CSS 等等。</p> <h3>缩进代码块</h3> <p>较旧的语法使用 4 个空格缩进来创建代码块：</p> <pre><code> function example() { return true; }</code></pre> <p>但是，围栏代码块更受欢迎，因为它们支持语法高亮并且在纯文本中更易于阅读。</p> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>专业提示：</strong>使用我们的 <a href="/tools/html-beautifier/">HTML 美化器</a> 在将代码粘贴到 Markdown 文档之前格式化代码。干净、格式良好的代码更易于阅读和维护。</p></div> <h2 id="tables">创建表格</h2> <p>表格将数据组织成行和列。虽然 Markdown 表格不如 HTML 表格灵活，但它们非常适合简单的数据呈现。</p> <h3>基本表格语法</h3> <p>使用竖线和连字符创建表格：</p> <pre><code>| 标题 1 | 标题 2 | 标题 3 | |----------|----------|----------| | 单元格 1 | 单元格 2 | 单元格 3 | | 单元格 4 | 单元格 5 | 单元格 6 |</code></pre> <p>竖线不需要完美对齐——Markdown 处理器会正确格式化它们。但是，对齐的竖线使表格在纯文本中更易于阅读。</p> <h3>列对齐</h3> <p>使用分隔行中的冒号控制文本对齐：</p> <pre><code>| 左对齐 | 居中对齐 | 右对齐 | |:-------------|:--------------:|--------------:| | 文本 | 文本 | 文本 | | 更多文本 | 更多文本 | 更多文本 |</code></pre> <ul> <li><code>:---</code> 左对齐（默认）</li> <li><code>:---:</code> 居中文本</li> <li><code>---:</code> 右对齐</li> </ul> <h3>实用表格示例</h3> <table style="width:100%;border-collapse:collapse;margin:1.5rem 0"> <thead> <tr style="background:var(--bg-secondary)"> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Markdown 变体</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">表格</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">任务列表</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">脚注</th> </tr> </thead> <tbody> <tr> <td style="border:1px solid var(--border);padding:0.75rem">CommonMark</td> <td style="border:1px solid var(--border);padding:0.75rem">❌ 否</td> <td style="border:1px solid var(--border);padding:0.75rem">❌ 否</td> <td style="border:1px solid var(--border);padding:0.75rem"></article> </main> <footer class="site-footer"> <div class="container"> <div class="footer-grid"> <div class="footer-col"><h4>Format</h4><a href="/tools/sort-lines/">Sort Lines</a><a href="/tools/remove-duplicates/">Remove Duplicates</a></div> <div class="footer-col"><h4>Encode</h4><a href="/tools/unicode-converter/">Unicode Converter</a></div> <div class="footer-col"><h4>Count</h4><a href="/tools/word-counter/">Word Counter</a><a href="/tools/character-counter/">Character Counter</a><a href="/tools/line-counter/">Line Counter</a><a href="/tools/text-statistics/">Text Statistics</a></div> <div class="footer-col"><h4>Convert</h4><a href="/tools/markdown-to-html/">Markdown To Html</a><a href="/tools/html-to-text/">Html To Text</a><a href="/tools/csv-to-json/">Csv To Json</a><a href="/tools/json-to-csv/">Json To Csv</a></div> <div class="footer-col"><h4>Company</h4><a href="/about.html">About</a><a href="/blog/">Blog</a><a href="/contact.html">Contact</a><a href="/sitemap.xml">Sitemap</a></div> </div> <div class="footer-bottom"> <span>© 2026 TxtTool. All processing happens in your browser.</span> <div class="footer-legal"><a href="/privacy.html">Privacy</a><a href="/terms.html">Terms</a></div> </div> </div> <div class="matrix-links" style="text-align:center;padding:10px 0;border-top:1px solid rgba(255,255,255,0.05)"><span style="color:#666;font-size:0.75em">More Tools: </span><a href="https://run-dev.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">run-dev</a><a href="https://img-kit.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">img-kit</a><a href="https://the-pdf.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">the-pdf</a><a href="https://nettool1.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">nettool1</a></div></footer> </body> </html>