正文

程序员写博客不头疼 用Markdown排版让文章整洁又高效 从零学起轻松上手排版技巧分享

/0 浏览量
0922

程序员写博客不头疼 用Markdown排版让文章整洁又高效 从零学起轻松上手排版技巧分享

嘿，你是不是也经历过这样的场景：辛辛苦苦写了一篇博客，结果贴到平台上之后，排版乱成一团，标题忽大忽小，代码缩进全乱，图片要么太大要么太小，最后不得不花大量时间在编辑器里调格式。

别急，今天咱们就聊聊一个能彻底解决这个问题的神器——Markdown。

为什么程序员都爱用Markdown？

先说说我自己在GitHub上看过的那些优秀开源项目的README文件，你会发现一个共同点：几乎都是用Markdown写的。代码清晰、结构明确、阅读舒服。

Markdown最大的好处就是——写作的时候不用管格式。你想表达什么，直接打出来就行，不需要像Word那样选字体、调间距、改字号。格式由Markdown语法自动生成，你只管写内容。

更重要的是，Markdown文件是纯文本格式，可以在任何平台、任何编辑器里打开，不会因为换了个软件就打不开或者格式乱了。

Markdown基础语法速查

标题

Markdown的标题用井号#表示，几个井号就是几级标题：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

这个规则很简单，井号越多标题越小。实际写作中，一般用一级标题做文章大标题，二级标题做章节，三级及以下标题做小节。

段落和换行

两个换行就是一个新段落，一个换行就是同一段落内的换行：

这是第一段。

这是第二段，和上面空一行。

这是第三段的第一行。
这是第三段的第一行后面的内容，单换行也会换行显示。

效果就是：

这是第一段。

这是第二段，和上面空一行。

这是第三段的第一行。 这是第三段的第一行后面的内容，单换行也会换行显示。

强调文字

如果你想强调某些文字，可以用粗体或斜体：

**这是粗体**

*这是斜体*

***这是粗斜体***

~~这是删除线~~

效果：

这是粗体

这是斜体

这是粗斜体

这是删除线

列表

列表分为有序列表和无序列表两种。无序列表用连字符-或星号*，有序列表用数字加点：

无序列表：
- 第一项
- 第二项
- 第三项

有序列表：
1. 第一步
2. 第二步
3. 第三步

列表还可以嵌套，只要在下一行缩进两个空格就行：

- 水果
  - 苹果
  - 香蕉
  - 橘子
- 蔬菜
  - 白菜
  - 萝卜

引用

用大于号>来表示引用，可以嵌套多层：

> 这是一级引用
> 
> > 这是二级引用
> 
> 回到一级引用

效果就是：

这是一级引用

这是二级引用

回到一级引用

引用经常用来标注”别人说的话”或者”代码注释”，很实用。

链接和图片

链接和图片的语法非常相似，唯一的区别是图片前面多了一个感叹号!：

[点击访问Google](https://www.google.com)

![MarkdownLogo](https://markdown-here.com/img/icon32.png)

图片的链接后面可以加个title属性，鼠标悬停时会显示：

![MarkdownLogo](https://markdown-here.com/img/icon32.png "Markdown Logo")

代码

这个功能对程序员来说太重要了。Markdown原生支持代码，而且区分行内代码和代码块。

行内代码用反引号`包裹：

在代码中，你可以这样使用：`console.log("Hello")`来打印信息。

效果：在代码中，你可以这样使用：console.log("Hello")来打印信息。

代码块用三个反引号`包裹，而且可以在第一行指定语言，这样能自动高亮：

```python
def hello():
    print("Hello, World!")

if __name__ == "__main__":
    hello()

const greeting = "Hello, Markdown!";
console.log(greeting);

.container {
  display: flex;
  justify-content: center;
  align-items: center;
}

注意看，代码块的语法是三个反引号开头，三个反引号结尾，中间夹着代码。第一行可以写语言名，比如python、javascript、css、java、go等等，渲染的时候会有对应的语法高亮。

进阶技巧：让文章更有层次感

表格

表格用竖线|和横线-来构建：

| 语言 | 特点 | 学习难度 |
|------|------|----------|
| Python | 简洁易读 | ⭐ |
| JavaScript | 前后端通吃 | ⭐⭐ |
| Rust | 内存安全 | ⭐⭐⭐ |

效果：

语言 特点 学习难度
Python 简洁易读 ⭐
JavaScript 前后端通吃 ⭐⭐
Rust 内存安全 ⭐⭐⭐

表格的竖线对齐不影响显示效果，但为了可读性建议对齐。第三行横线和竖线之间至少要有一个空格，冒号:用来控制对齐方式——左边对齐、右边对齐或居中：

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容   | 内容     | 内容   |

分割线

用三个或更多的连字符---或星号***来添加水平分割线：

---

***

效果就是两条不同的横线，可以用来分隔文章的不同部分。

任务列表

任务列表特别适合写TODO或者步骤说明：

- [x] 安装Markdown编辑器
- [x] 学习基础语法
- [ ] 写一篇博客实践
- [ ] 分享给朋友

效果：

  • [x] 安装Markdown编辑器
  • [x] 学习基础语法
  • [ ] 写一篇博客实践
  • [ ] 分享给朋友

实际写作场景演示

光说不练假把式，咱们来看一个实际的文章结构示例。假设你要写一篇介绍Python基础语法的教程：

# Python基础语法入门

> 本文适合完全没有编程经验的初学者，从零开始带你走进Python的世界。

## 为什么选择Python？

Python有以下几个显著优势：

- **语法简洁**：代码读起来像英语一样自然
- **生态丰富**：拥有海量的第三方库
- **跨平台**：Windows、Mac、Linux都能运行
- **就业广泛**：数据分析、人工智能、Web开发都有需求

## 第一个Python程序

让我们从最经典的"Hello World"开始：

```python
print("Hello, World!")

就这么简单，一行代码就能在屏幕上输出文字。print()函数用来输出内容，双引号或单引号包裹的是字符串。

变量和数据类型

Python中的变量不需要声明类型，直接赋值就行：

# 整数
age = 25

# 浮点数
height = 175.5

# 字符串
name = "小明"

# 布尔值
is_student = True

# 列表
fruits = ["苹果", "香蕉", "橘子"]

条件判断

age = 20

if age >= 18:
    print("你已经成年了")
else:
    print("你还是个未成年人")

小结

掌握了以上基础，你就可以开始用Python做一些有趣的事情啦！下一篇文章我们会讲循环和函数，敬请期待~

如果这篇文章对你有帮助，记得点赞收藏哦！ “`

这篇文章包含了标题、引用、列表、代码块、段落、分割线、emoji表情——该有的都有了，而且写起来非常自然，不用动脑子去想格式。

工具推荐：让写作更顺滑

现在你已经知道Markdown是什么、怎么用了，接下来需要一个趁手的工具。推荐几个：

本地编辑器

  • Typora：所见即所得的Markdown编辑器，写的时候直接显示渲染后的效果，非常直观。缺点是收费，但可以免费使用。
  • VS Code：程序员神器，安装一个Markdown预览插件就能实时预览，完全免费。
  • Obsidian：双向链接笔记软件，支持Markdown，适合写长文章和知识管理。

在线平台

  • 知乎/掘金/CSDN：都支持Markdown，直接在编辑器切换Markdown模式就行。
  • Notion：支持Markdown输入，自动转换成格式，适合做文档和知识库。
  • 语雀：阿里出品，Markdown体验不错，还有团队协作功能。

常见问题解答

Q：Markdown能不能写复杂的排版？

Markdown本身语法比较简洁，但大多数平台都支持嵌入HTML。如果你的平台支持，可以用HTML来做一些特殊排版，比如插入复杂的表格或者调整样式。不过日常写作完全够用。

Q：图片怎么传？

大多数平台支持直接粘贴截图或者上传本地图片，会自动生成Markdown的图片语法。也可以用图床（比如Imgur、SM.MS）上传图片后获取链接粘贴进去。

Q：代码块支持哪些语言？

几乎支持所有主流编程语言，常见的包括：python、javascript、java、go、rust、c、cpp、html、css、sql、bash、json、yaml等。不会标注的话就不标，大部分平台会默认渲染。

Q：写完了怎么导出？

Markdown文件后缀是.md，可以随时导出为HTML或PDF。VS Code有导出插件，Typora也支持导出多种格式。

最后想说

学会Markdown其实不需要很长时间，基础语法几个小时就能掌握，剩下的就是多写多用。你会发现，一旦习惯了Markdown的写作方式，就再也回不去Word那种需要反复调格式的痛苦了。

程序员写博客，图的就是一个高效。Markdown把格式这件事交给语法，你只需要专注内容本身。写出来的文章结构清晰，读者看着舒服，你自己写的时候也顺畅。

今天就分享到这里，如果你正好在纠结博客排版的问题，不妨花十分钟试试Markdown。相信我，你会回来感谢我的。

有任何问题欢迎在评论区交流，咱们下期见~

-- 展开阅读全文 --