原文Markdown基础语法介绍 | Colin Gretzky的博客本文介绍 Markdown 笔记格式的基础功能涵盖核心语法和使用要点适合初学者快速上手。Markdown 简介Markdown 是一种轻量级的标记语言由 John Gruber 于 2004 年设计。它的核心理念是让写作者专注于内容本身而非排版样式——用简单的符号标记格式源码可读渲染美观。优势特性说明沉浸写作纯键盘操作无需鼠标切换工具栏写作流不中断高兼容性支持所有主流平台GitHub、Obsidian、Notion、飞书等内容迁移零成本结构清晰标题层级、列表、引用一目了然即使纯文本状态下也保持可读性低学习成本核心语法只需几分钟即可掌握公式能力强基于 LaTeX 语法可渲染从简单到复杂的各类数学公式生态完善大量编辑器、插件、主题、转换工具支持局限性样式统一但不够灵活Markdown 的设计目标是足够好用而非无所不能。复杂的排版如多栏布局、精确控制间距需要借助 HTML 或 CSS 补充输出格式依赖渲染器同一份 Markdown 在不同平台上的渲染效果可能存在细微差异可能被误认为 AI 生成现在许多 AI 输出默认使用 Markdown 格式尤其带 emoji 的 Markdown 文本在非 Markdown 环境中粘贴时显得突兀容易让人误以为是 AI 直接复制的结果块的概念Markdown 引入了块Block的概念——这是它区别于传统文本编辑器的核心设计之一。什么是块在 Markdown 中内容以块为单位组织。每两个块之间用空行隔开每个块可以独立设定自己的类型标题、段落、列表、引用、代码块、公式块等。┌─────────────────────┐ │ 这是一个段落块 │ ← 段落块 │ 换行继续写仍是同一块 │ └─────────────────────┘ ← 空行块的分隔线 ┌─────────────────────┐ │ 这是另一个段落块 │ ← 新的段落块 └─────────────────────┘在 Obsidian 这类块编辑器中按回车会关闭当前块并创建一个新的块新块可以切换为不同的类型。块的特性①块是原子单位一个块是一个不可分割的整体。块内的所有文本共享同一套格式设定——你不能让块内的前半部分是标题、后半部分是普通文本。每当你切换块类型改动会作用于块内全部内容。正确理解# 这一整行都是标题1 这里是普通段落 |← 整个块 →|做不到的事情# 这部分是标题 ← 无法实现同一块内混合不同格式 这部分又是普通文本② 换行规则在一个块内部直接按回车单个换行会产生新段落不是文本内部的软换行。要在块的内部换行需要Shift Enter回车这是第一行同一块内 这是第二行仍然属于同一个块 这是新的段落块中间有空行这个规则的好处是即使 Markdown 源码没有自动换行渲染后的阅读体验仍然清晰③ 块类型的多样性Markdown 常见的块类型包括块类型语法标记用途段落无特殊标记普通文本标题#~######层级标题引用引用内容无序列表-/*列表项有序列表1.编号列表代码块代码片段公式块$$数学公式层级与结构编辑所有 Markdown 符号都应在英文输入法下输入半角符号否则可能因字符编码不匹配导致格式无效。标题用#加空格表示标题层级。#的个数对应标题的级别# 标题1文章大标题 ## 标题2章节标题 ### 标题3子章节 ###### 标题6最小标题大小接近加粗正文注意区分标签与标题#与文字之间有空格 标题#与文字之间无空格 标签Tag用于分类和检索# 这是一个标题 #这是一个标签引用在文本的最左侧输入将该段设为引用样式 此处输入要引用的文本引用块内部文本样式加粗、斜体等仍然有效但大部分块级格式标题、列表会失效此处为引用效果标题功能失效加粗和斜体仍然有效列表无序列表用-、*或加空格开头- 项目一 - 项目二 - 子项目缩进两个空格有序列表用1.、2.加空格开头1. 第一步 2. 第二步 1. 子步骤缩进两个空格代码块用三个反引号包裹代码片段可在开头指定语言以启用语法高亮python print(Hello, World!) 公式块用两个美元符号$$包裹 LaTeX 公式$$ E mc^2 $$注意必须使用美元符号$而非人民币符号¥否则无法识别。文本样式文本样式作用于块内的部分文字与块级格式不同它们可以混合使用。快速参考样式语法快捷键Win / Mac效果加粗**文字**CtrlB / CmdB加粗效果斜体*文字*CtrlI / CmdI斜体效果删除线~~文字~~无默认快捷键删除线效果高亮文字无默认快捷键高亮效果代码文字无默认快捷键行内代码样式链接[文字](url)CtrlK / CmdK链接效果图片无默认快捷键显示图片详细说明加粗与斜体是最常用的文本样式支持嵌套使用**加粗文本** *斜体文本* ***加粗加斜体***删除线用两个波浪号包裹。注意区分中文全角和英文半角~——只有后者有效~~这句被删掉了~~高亮用两个等号包裹在 Obsidian 等支持该语法的编辑器中呈现荧光笔效果这是高亮文字行内代码用单个反引号包裹适合在段落中标记函数名、文件名或短代码片段使用 git commit 命令提交更改。链接的格式为[显示文字](目标地址)支持网页链接和笔记内部链接[GitHub](https://github.com) [本地笔记](我的笔记.md)图片的格式为替代文字在图片加载失败时显示公式行内如果需要在一段文字中嵌入公式而非独立公式块使用单个美元符号包裹爱因斯坦的质能公式 $E mc^2$ 是物理学中最著名的方程之一。效果爱因斯坦的质能公式 E mc^2 是物理学中最著名的方程之一。分割线如果需要在文章输入分割线则要输入---效果:总结Markdown 语法速查───────────────────────────────────────────── 类型 语法 ───────────────────────────────────────────── 标题 # H1 → ###### H6 加粗 **文字** 斜体 *文字* 删除线 ~~文字~~ 高亮 文字 行内代码 代码 链接 [文字](url) 图片  引用 文字 无序列表 - 项目 有序列表 1. 项目 代码块 语言 公式块 $$ 行内公式 $公式$ 标签 #标签无空格 分隔线 --- ─────────────────────────────────────────────