林杏仁刚开始接触“Goland基础语法”这个词时，很多人第一反应是：Goland是不是一门编程语言？就像搜Python基础语法、Java基础语法那样，先学变量、循环、函数、类？我最早也这么以为，后来真去查了才发现，网上搜出来的“Goland使用教程”，大部分讲的都是Typora这款Markdown编辑器的使用。Goland其实是Typora在国内早期流行起来时的中文称呼，也有可能是一些老用户习惯性的叫法，它本身不是编程语言，而是一个非常顺手的文本编辑器。所谓“Goland基础语法”，真正要学的内容，就是Markdown基础语法。
这篇文章就围绕“Goland里到底要怎么用Markdown语法”这件事，把标题、正文、列表、表格、代码块、引用、图片这些最常用的语法全部捋一遍，同时结合我在实际写技术文档、记笔记、导出PDF/Word过程中的经验，把容易踩的坑一并说清楚。不管你是刚开始学笔记语法的新手，还是已经在用Typora但总被各种小问题卡住的用户，这篇文章都能给你一份能直接照着用的实操指南。而且，这套基础语法学完之后，不光Goland能用，GitHub的README、飞书文档、语雀、Obsidian、Notion、还有各种博客平台，几乎全都通用，学一次到处用。
1. Goland到底是啥？先别急着把它当编程语言
1.1 Goland和Typora的关系，以及名字的由来
如果直接搜索“Goland”，你会发现结果混着两类东西：一类是JetBrains出的Go语言IDE，叫GoLand；另一类就是Typora编辑器，在很多中文教程和论坛帖子里被叫做“Goland”。本文说的显然是后者，也就是Typora——一个强调“所见即所得”的Markdown编辑器。早期版本里，Typora曾有过带中文色彩的名称，加上输入法里goland比typora好打，很多博主就顺口叫成了Goland，后来这个名字越传越广，反而成了一个约定俗成的搜索词。
我自己最早也是从一篇“Goland使用教程”入门的，当时还以为自己下载了个高级IDE，结果双击打开发现就是个极简的白色编辑界面，输入几个井号和文字之后自动变成了标题样式，瞬间觉得“这东西有点意思”。所以如果你想搜的是Typora的功能、快捷键、导出设置，建议直接搜“Goland使用教程”“Typora教程”“Markdown基础语法”，内容基本是一套。
1.2 Markdown基础语法和编程语言基础语法有什么区别
很多人把“Goland基础语法”和“Python基础语法”“Java基础语法”放在一起搜索，以为它们是同类知识。这个理解要稍微纠正一下：Python和Java是编程语言，语法决定的是“程序怎么执行”，要学变量、循环、函数、类、异常处理这些东西；而Markdown是一种轻量级标记语言，语法决定的是“文本怎么排版”，要学的是井号代表几级标题、星号代表加粗、反引号代表代码。前者面向机器，后者面向读者。
但从学习逻辑上看，它们又非常像，都是“先记住符号规则，再通过大量练习变成肌肉记忆”。而且，Markdown这门“语法”的学习成本极低，花半小时就能覆盖日常工作里80%的用法。所以别被“基础语法”四个字吓到，它的难度大概只有Python基础语法的十分之一。
1.3 Goland能做什么，适合谁用
Goland（Typora）的核心能力，是让你专注于内容本身，而不是排版。你只需要写纯文本，用简单的标记符号标注结构，编辑器就会实时渲染成漂亮的排版结果。写技术博客、记学习笔记、写项目README、整理面试题、做会议记录、写课程大纲，都非常顺手。
适合使用的群体也很明确：程序员、技术博主、产品经理、运营编辑、学生、科研人员，以及一切需要经常和文档打交道的人。尤其是那些“想把笔记写得好看但又不愿意折腾Word排版”的人，Goland就是那个“懒人救星”。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 写正文必会的Markdown基础语法：Goland里的核心标记
2.1 标题与段落：井号数量决定层级
在Goland里创建标题，最常用的方式就是在行首输入“#”，后面跟一个空格，再接标题文字。一个“#”是一级标题，两个是二级标题，最多支持六个“#”。注意，井号和文字之间的那个空格不能省略，省略之后Goland会把它当成普通文本，不会渲染成标题。
我刚开始写的时候就犯过这个错，总觉得空格多余，直接写“##标题”，结果半天没看到样式变化，还以为软件坏了。后来才发现是空格的问题。另外还要记住，标题和正文之间最好空一行。在Markdown语法里，空一行代表段落分隔，如果不空行，很多解析器会把相邻行当成同一段落，排版会乱。
markdown复制# 一级标题
## 二级标题
### 三级标题
这里有个实用的建议：一篇文章一般用不到一级标题，因为一级标题往往是文档总标题，正文里直接从二级、三级开始比较合理。比如我这篇博文，就是在Goland里用二级标题作为章节，三级标题作为小节，层级一目了然。
2.2 加粗、斜体、删除线、行内代码：四种最常用的字级标记
写文章时经常会需要强调某些词，Markdown提供的字级标记非常简单：
- 加粗：在文字两侧各加两个星号，“加粗”
- 斜体：在文字两侧各加一个星号，“斜体”
- 删除线：在文字两侧各加两个波浪线，“
删除线” - 行内代码：在文字两侧各加一个反引号，“
代码”
很多人在手机上打字时容易把星号打成乘号“×”，或者输入法自动把反引号变成中文的“·”，这两种情况都会导致语法失效。Goland有个不错的机制，输入成对的星号或反引号后，会自动把光标定位到两个符号中间，并且先给你显示符号本身，等光标移开后才渲染成样式。如果你发现文字一直显示原始符号，大概率是当前光标还在符号区域内，或者符号被中文输入法“吃”掉了。
2.3 列表与任务清单：无序、有序、嵌套
列表是Markdown写作中出现频率最高的语法之一。无序列表用“-”“*”“+”加空格开头，有序列表用“1.”“2.”加空格开头。
markdown复制- 无序列表项一
- 无序列表项二
1. 有序列表项一
2. 有序列表项二
Goland对列表的智能化处理做得很好：在无序列表项末尾按回车，会自动生成新的列表项；连续按两次回车，就会退出列表状态。有序列表也不必手动维护编号，第一行写了“1.”，第二行Goland会自动显示“2.”，即使中间插入了新行，编号也会自动调整。
嵌套列表稍微特殊一点：在子列表前面加两个空格或者一个Tab，就能生成第二层列表。这里有个常见问题：很多人敲了Tab发现子列表没有缩进，因为Goland在列表状态下按Tab可能只是增加缩进，需要看实际效果。如果发现子列表项始终和父级平级，就把Tab换成两个空格再试一次。
任务清单是列表里特别适合做待办事项的一种形式，写法是在无序列表基础上加上“[ ]”或“[x]”：
markdown复制- [ ] 未完成任务
- [x] 已完成任务
在Goland里，点击方框可以直接切换完成状态，这个功能用来做学习计划特别好用。我写技术文章时，经常在文末放一个任务清单，把待验证的细节列进去，写完一项勾一项，效率高很多。
2.4 引用与分割线：让文章层次更清晰
引用块主要用于引用别人的话、标注注意事项、或者给某段内容做提示。语法非常简单，在行首输入大于号“>”，后面接文字即可。
markdown复制> 这是一段引用文字。
Goland里输入“>”后按回车，会自动延续引用状态，引用内容之间也可以嵌套，比如在一个引用里再放一个“>”就会变成嵌套引用。我写技术文章时，习惯用引用块来标注“重要提示”或者“填坑提醒”，读者一眼就能抓住关键信息。
分割线用三个连续的短横线、星号或下划线即可，独立成行。不过要注意：短横线行首不能有空格，否则Goland可能把整行当成列表项处理。分割线在视觉上能把前后文隔开，适合在笔记中区分不同主题。
2.5 链接与图片：方括号加圆括号的固定组合
Markdown中链接的通用格式是“方括号包住显示文字，圆括号包住实际地址”：
markdown复制[Goland使用教程](https://example.com)
图片的格式只是在链接前面加一个英文感叹号：
markdown复制
图片描述字会在图片加载失败时显示，也能帮助屏幕阅读器理解内容，建议不要省略。Goland对本地图片有个非常友好的特性：直接拖拽图片到编辑器里，它会自动生成路径并插入图片语法。对新手来说，这就免去了手动输入路径的麻烦。
但图片路径有一个隐藏的坑：如果把图片直接拖入，Goland默认会复制图片到当前文档所在的“assets”文件夹，并生成相对路径。如果你没有保存过文档，图片会被存到临时目录，之后文档移动位置，图片就失效了。所以第一步一定要先保存文档，再拖入图片。
2.6 表格：最容易被Excel思维带偏的语法
表格在Markdown里算是稍微复杂一点的语法，它不像Excel那样可视化操作，而是用管道符“|”和短横线“-”来构建。
markdown复制| 功能 | 语法 | 示例 |
| --- | --- | --- |
| 加粗 | 两个星号 | **文本** |
| 斜体 | 一个星号 | *文本* |
表格结构分成两部分：第一行是表头，第二行是分隔行，用“|---|”表示每列的左右对齐方式，下面的行就是表格数据。默认左对齐可以只写“---”；写“:---”表示左对齐，“---:”表示右对齐，“:---:”表示居中对齐。
写表格时最容易出的问题有两个：一是忘记写第二行分隔行，Goland会直接把整块内容当成普通文本；二是中文输入法下的竖线“|”变成了全角符号“｜”，也会导致无法渲染。还有个小技巧：在Goland里插入表格，可以右键选择“插入→表格”，编辑器会自动生成一个3列的表格骨架，再去填充内容就行，比自己手敲要省事得多。
2.7 代码块与围栏语言标记：用好反引号和语言标识
代码块是技术类文章里出现频率最高的元素，分为行内代码和代码块两种。行内代码就是在一对反引号之间写代码，适合记录变量名、命令、函数名；多行代码块则需要用三个反引号作为开始和结束标记。
关键在于：三个反引号之后可以紧跟语言名称，比如“python”“javascript”“bash”“html”，Goland会基于这个标识做代码高亮。
python复制print("Hello, Goland!")
我写技术笔记时一定会写语言标记，不仅为了高亮好看，更重要的是导出HTML或分享到博客平台时，代码高亮会自动生效，读者阅读体验会好很多。不写语言标记，代码块也能用，但就是白底黑字，没有高亮，看起来像纯文本。
三个反引号的输入位置也有讲究：在中文输入法下，反引号按钮是键盘左上角“Esc”下方的那个键，按一下进入英文输入法再按，否则容易打出中文顿号“、”。这个问题我在手机和部分笔记本键盘上都遇到过，挺耽误时间的。
3. 为什么Goland能“所见即所得”：渲染机制与CSS定制
3.1 从解析到渲染：Goland其实比Word更懂“语法”
Goland最大的卖点，就是“所见即所得”——输入“# 标题”，敲回车，标题样式瞬间出现。这背后其实是它内置了Markdown解析引擎和浏览器内核，每次你输入内容，软件都会实时把Markdown语法解析成一棵结构树，再把结构树渲染成HTML，最后套用CSS主题展示出来。
理解这个机制有什么用？用处很大。当某个语法没有生效时，你第一反应不该是“软件坏了”，而是“我的输入是不是不符合Markdown规范”。比如表格没渲染，说明管道符和短横线的结构不对；引用没生效，说明行首的“>”后可能多了空格，或者用了中文大于号。Goland的实时渲染，本质上是在帮你检查语法，只是它不够“啰嗦”，不会弹出错误提示，而是直接以“不渲染”的方式告诉你：这一段我认不出来。
HTML和CSS基础语法这块，虽然大多数人不会专门学，但如果你想让自己的Goland笔记更好看一点，稍微懂一点CSS会非常加分。这也就是为什么很多人会同时搜“html+css+js基础语法”和“Goland基础语法”——前者是给后者打底的。
3.2 用CSS片段改造标题配色，让笔记有专属风格
Goland允许你写CSS片段来覆盖默认主题样式。点击“文件→偏好设置→外观”，在“自定义CSS”或“CSS片段”区域新建一个片段，就能针对所有渲染元素做样式修改。
举个例子，我想让所有二级标题都变成蓝色并加大字号，在CSS片段里写：
css复制h2 {
color: #2c7cc3;
font-size: 1.6em;
border-bottom: 2px solid #e1e8f0;
padding-bottom: 6px;
}
保存后，文档里所有“## 二级标题”立刻变成带蓝色下划线的样式。这种定制能力基本就是把Markdown渲染出来的HTML做了一层“皮肤”。如果你完全没学过CSS，也不用急着背，只要照葫芦画瓢改颜色和字号即可，等以后需要时再系统地学。
不过要注意：CSS片段是全局生效的，改的是所有文档的渲染样式，不是某一篇文档独有的。如果你只想让某一份文档特殊，可以在文档内直接嵌入一对“style”标签，写临时的CSS规则。
3.3 内嵌HTML与CSS：Markdown语法之外的扩展手段
Markdown本身是一套弱标记语法，表达力有限，遇到复杂排版时就力不从心。Goland很聪明地保留了一个通道：允许在文档里直接写HTML标签。
比如你要让两段文字并排显示，Markdown本身做不到，但可以用HTML的“div”加浮动实现；你要插入一个带背景色的提示框，Markdown做不到，但可以写：
html复制<div style="background:#f9f0f0; padding:12px; border-left:4px solid #d9534f;">
这里是自定义提示框内容。
</div>
Goland会直接渲染这段HTML，效果和网页一模一样。这个特性让我非常喜欢，因为很多博客平台的Markdown编辑器也支持这种写法，写一次，复制到博客后台也基本能保持原样。当然，前提是目标平台允许嵌入HTML，有些平台出于安全考虑会过滤掉“script”标签，但“div”“span”“img”“a”这些常用标签一般都能保留。
4. 实操：用Goland基础语法搭一篇完整的技术笔记
4.1 从零开始：新建文档、保存、设置主题
打开Goland后，界面异常简洁，没有新建按钮、没有菜单栏挤占桌面，这就是它刻意为之的“极简”理念。你只需要直接输入内容，第一行写“# 笔记标题”，然后Ctrl+S保存，Goland会弹出保存窗口。建议所有笔记统一放一个文件夹，用“日期+主题”命名，例如“20250618-Goland学习笔记.md”。
Goland的主题设置可以在“偏好设置→外观”里切换，有“Github”“Newsprint”“Night”“Pixyll”等一堆免费主题。我日常用“Github”主题，代码高亮清晰，夜间写作则切换“Night”，黑底白字对眼睛友好。如果你刚开始用，建议默认主题先别动，先熟悉语法，等习惯后再折腾外观。
4.2 实战模板：一篇兼顾标题、列表、表格、代码块的笔记
给你一份我常用的技术笔记模板，整体结构完全用Markdown基础语法搭起来，改改就能用：
markdown复制# 项目调研：XX系统
## 1. 需求背景
> 一句话说明为什么要做这个项目。
## 2. 方案对比
| 方案 | 优势 | 劣势 | 结论 |
| --- | --- | --- | --- |
| 方案A | 成本低 | 维护难 | 备选 |
| 方案B | 性能好 | 上手慢 | 推荐 |
## 3. 核心代码
\```python
def main():
print("Hello")
\```
## 4. 待办事项
- [x] 完成需求分析
- [ ] 开发联调
- [ ] 写测试用例
这份模板里包含了标题、引用、表格、代码块、任务清单五种语法，基本覆盖了日常笔记的80%场景。我建议你把它复制到Goland里跑一遍，看到实时渲染效果后，再逐行改成自己的内容，这样学起来远比一条条背语法快。
4.3 导出Word、PDF、HTML的正确姿势
笔记写完之后，导出是个高频需求。Goland在“文件→导出”菜单里提供了PDF、HTML、Word等多种格式。我最常用的是“导出→PDF”，因为排版和屏幕所见几乎一致，适合发给别人阅读，也不怕被改动。
导出PDF时如果文档包含代码块，中文字体和代码字体可能不一致，偶发乱码。遇到这种情况，先确认系统里装了中文字体（比如思源黑体、微软雅黑），再在导出设置里选择字体。导出Word则适合需要二次编辑的场景，但Markdown的复杂表格和CSS样式在Word里会“打折扣”，需要手动微调。
直接复制粘贴到微信公众号后台或其他富文本编辑器时，推荐用“导出→HTML”，然后在浏览器里打开HTML文件，全选复制，再粘贴到目标编辑器，格式保留得最好。这个方法我用过无数次，基本是零损失迁移。
4.4 图片路径管理：别让笔记一搬家就“缺图”
Goland的图片处理策略是“相对路径优先”。保存文档后，拖入图片会在当前目录下生成一个“assets”文件夹，并把图片拷贝进去，文档里的图片路径自动变成“assets/xxx.png”。
这样做的好处是：只要整个文件夹一起拷贝或压缩，图片就不会丢。缺点是：很多人把“assets”文件夹漏掉，只把“md”文件发给别人，结果对方看到的全是裂图。我的习惯是，如果笔记要长期保存或分享，先把“.md”文件和“assets”文件夹一起打包成zip，或者直接用“导出→HTML”把所有图片以Base64形式内嵌进HTML，一张图都不会丢。
5. 常见问题与排查技巧实录
5.1 为什么敲了回车，却没有新起一个段落
这个问题几乎每个刚用Goland的人都会碰到。原因很简单：Markdown语法中，单个回车只是软换行，不会产生新段落；要真正分段，需要空一行。你在Goland里如果只按一次回车，往往只会看到光标移到下一行，但样式仍然是同一段落里的换行，视觉上不会留白。
解决方法是：想要分段，就按两次回车，在两段文字之间留一个空行。如果你确实只想换行但不想分段，可以在一行结尾加两个空格再回车，Goland会渲染成“软换行”。不过这个功能在导出成HTML时更明显，屏幕上的渲染效果可能看不出区别。
5.2 表格怎么不显示？多半是分隔行或全角符号的问题
表格是故障率最高的语法。排查顺序就三步：
- 确认第二行分隔行写了“|---|”，没有缺失。
- 确认所有竖线都是英文半角“|”，而不是中文全角“｜”。
- 确认每行列数一致，比如第一行有4列，后面每行也要有4个竖线分割出来的区域。
我遇到过一个特别隐蔽的坑：从Word里复制一段含表格的内容到Goland，表面的竖线看着没问题，实际上混入了全角空格和连续空格，Goland解析失败。这种情况我直接在Goland里手动重打表格，比重排快得多。
5.3 代码块没有高亮，或者语言标记不生效
代码块没有高亮，先看反引号是不是完整的三对，再看语言标记写没写。如果语言名称写错，比如“js”和“javascript”两种写法有些主题都认，但“jvs”这种拼写错误就完全无效。比较稳妥的做法是只写常见名称：“python”“java”“c”“cpp”“javascript”“typescript”“bash”“sql”“json”“html”“css”。
另外，三个反引号后面不要有空格。有人习惯写上“``` python”，多了空格后某些解析器也能识别，但Goland的兼容性会受影响。我自己测试过，紧贴语言名的写法最稳。
5.4 中文全角符号“偷走”了语法
有时候一条语法怎么检查都不错，但就是不渲染，最后发现是标点符号的全半角问题。冒号、括号、大于号、星号、竖线、问号，这些符号一旦被中文输入法切换成全角状态，Markdown解析器就不认。
把输入法切成英文状态再输一遍，基本都能解决。这里有个习惯：在Goland里写纯文本内容用中文输入法没问题，但凡是输入语法符号（如#、*、`、|、>），都建议临时切换英文输入法。这是最省心的方案，比事后再排查快得多。
5.5 复制粘贴时Markdown符号没反应
从网页复制一段文字到Goland，里面可能带着网页的富文本格式，粘贴后Goland会把它转成Markdown格式。但有些网页复制的内容里，特殊符号是经过转义的，比如“*”代表星号，粘贴后反而显示成星号本身，而不是加粗效果。
处理方法：粘贴时尽量选择“无格式文本”，或者粘贴后检查一遍关键符号。如果发现大量转义符号，我一般会先粘贴到一个纯文本编辑器中转一圈，再复制到Goland里，问题就少很多。
6. 学习路径：让Goland基础语法和HTML/CSS/Python基础语法互相配合
6.1 为什么搜Goland的人，也会去搜HTML和CSS基础语法
Markdown渲染出来的页面本身就是HTML，Goland的实时预览本质上就是一个网页渲染器。当你接触了“自定义主题”“CSS片段”“内嵌HTML”这些进阶功能后，HTML和CSS的作用就会自然浮现。所以很多人在学会Goland基础语法后，会继续搜“html+css+js基础语法”，不只是赶热度，而是真的能用上。
比如你想在笔记里插入一个进度条、一个带阴影的卡片、一个自定义按钮，Markdown本身做不到，但用HTML+CSS几十行就能做出来。我也推荐你把Goland当作学HTML和CSS的“实验场”：每次写个带样式的小块，Goland立刻渲染出来，比在浏览器里开开发者工具直观得多。
JS的基础语法在Goland里能用的场景稍少，因为Typora出于安全考虑会限制脚本执行，但如果你用Goland写前端学习笔记，顺手记录JS基础语法、运行结果，这本身就是一种极佳的学习方式。技术写作和编程学习完全可以互相支撑。
6.2 个人推荐的入门顺序与练习方法
如果你完全是零基础，我的建议是：
- 先用半小时把本文第2章的所有语法在Goland里敲一遍，不做笔记，只做练习。
- 把一份已有的Word笔记手动转成Markdown格式，遇到不会的语法就查，这个过程中掌握得最快。
- 尝试给Goland设置一个自定义CSS片段，哪怕只改改标题颜色，也算体验了HTML和CSS的联动。
- 系统整理一套自己的笔记模板，固定用同一种标题层级和列表风格，保证可复用性。
- 在使用中自然体会哪些语法是高频使用的，哪些一年用不了几次。比如我刚学时把“脚注”“锚点”“数学公式”都背了一遍，实际写作中脚注用得少，数学公式则是写学习笔记时才偶尔用。
练习时长不用太长，每天20分钟，坚持一周，Goland基础语法就能成肌肉记忆。到那时，你会发现写Markdown就像打字一样自然，不会再被符号拦住思路。
我从自己的使用体验来说，Goland也好，Typora也罢，最打动我的不是某个高科技功能，而是“让写作回归内容”这件事。语法只是入口，真正有价值的是你写出来的笔记、文章和思考。希望这份基础语法指南能帮你把入口走顺，后面的路，就交给你的内容了。