你有没有过这种时刻:凌晨一点,灵感来了,你在一款富文本编辑器里噼里啪啦敲了三千字,插入几张配图,调了几个小标题的颜色,觉得这篇文章堪称完美。第二天醒来,打开后台一看——图片错位、字号乱跳、复制出去到公众号直接变成一团乱麻。你花十分钟写文章,花一个小时修排版。
问题的根源不在你,在于富文本编辑器那层”所见即所得”的画皮。它背后其实是一堆 <span style="font-size:14px"> 之类的冗余代码,平台一升级、样式表一变,你的排版就跟着崩。而写博客这件事,本该像跟人说话一样简单——Markdown 就是把”说话”直接变成”成文”的那套方式。它 2004 年由 John Gruber 创造,初衷就一句话:让文本在纯状态下就可读,格式化符号少到可以忽略。到今天,Hugo、Hexo、Jekyll、Ghost、Astro,甚至装了插件的 WordPress,全部以 Markdown 为内容源。可以说,你不会 Markdown,等于在博客这条路上赤脚走路——能走,但硌脚。
别把 Markdown 当语法,把它当”一次性写作、到处发布”的通行证
很多人学 Markdown 的方式就错了:背语法表。
这张图你收藏了就够了。但比语法更重要的是理解它的底层逻辑:Markdown 文件是纯文本。纯文本意味着什么?意味着二十年前的电脑能打开它,二十年后的电脑也能打开它;意味着你的文章不是某个平台的”私有资产”,而是躺在本地硬盘上的一堆 .md 文件,想搬到哪个平台就搬到哪个平台,Git 还能给你做版本控制,写错了随时回滚。
有博主在 2026 年更新的一篇文章里说得很直白:他 2017 年开始用 Markdown 写博客,后来又用它写书,”纯文本写作加即时预览彻底改变了我写博客的方式,再也不用跟富文本编辑器搏斗了”。这话说到了点子上——Markdown 最大的价值不是”快”,而是可迁移性。你在一处写作,可以在博客、GitHub、知乎、公众号(借助编辑器转换)之间反复横跳,内容永远不会被锁死在某个平台的编辑器里。
新手最容易踩的三个坑,踩过一次就长记性
坑一:图片是死穴,不是语法
 这行谁都会写,但 80% 的”Markdown 文章显示 broken”都栽在图片上。本地路径 ./image.jpg 发布到线上就 404,因为服务器上根本没有这个路径。靠谱的解法只有一个:图片上对象存储或图床,正文里放 HTTPS 直链。这也是 V2EX 上那位写了五年静态博客的老哥,忍不住自己动手撸一个专属编辑器的原因——就为了自动修图床、自动处理图片路径。
坑二:标题层级乱飞
# 是一级标题,## 是二级,一篇文章只该有一个 #。有人随手 # 到底,结果生成的页面 SEO 稀烂、目录插件直接罢工,移动端上字号大得像海报。记住一个口诀:一级标题是文章名,二级标题是骨架,三级往下能不用就不用。
坑三:front matter 字段写不全
静态博客每篇文章开头都有这么一段 YAML 元数据:
---
title: "文章标题"
date: 2026-11-22
tags: ["写作", "工具"]
description: "给搜索引擎看的摘要"
---
description 不写,搜索引擎就随便抓一段正文当摘要;date 格式不对,文章可能排到归档最后一页。这些小字段就是文章的”身份证”,宁可多写两行,别留白。
工具不用多,一条”写→推→自动上线”的链路就够
2026 年回头看,写作工具其实早就收敛了。个人写作者,Typora 这类低干扰编辑器足够;资料多的,上 Obsidian 或 Joplin 做归档;团队协作,先用 HackMD 共编,再加一个明确的审核节点——团队文档的第一优先级从来不是工具多先进,而是版本别乱。
真正值得花心思的是发布链路。现在最主流的个人博客工作流是这样:
本地用 Markdown 写完,丢进 Hexo 或 Hugo 的 posts 目录,commit 到 GitHub,GitHub Actions 自动构建、自动部署到 Pages 或 CDN。全程你只做两件事:写,推(git push)。有位跑双语博客的博主总结得很到位:个人博客死掉的原因,九成不是网站难搭,而是”发布太重”——每次发帖都要手动传文件、手动构建,重复几次人就懒了。把发布变成自动流水线,写博客才能从”运维任务”变回”表达欲望”。
选型上也别纠结:会 Node.js 选 Hexo,追求构建速度选 Hugo(Go 写的,几千篇文章秒级生成),想用 React 生态选 Astro 或 Next.js。它们吃的都是同一个东西——你的 .md 文件。这就是 Markdown 的恐怖之处:工具可以随便换,资产纹丝不动。
写给搜索引擎和人看的那些细节
Markdown 只管内容,SEO 还得你自己上心,但成本极低。三件事就够了:
一是图片必须写 alt 文本。 里的 alt 不只是无障碍要求,搜索引擎图片流量的一大入口就是它。二是标题里自然带关键词,## 和 ### 是页面结构,爬虫顺着它爬。三是内部链接多用相对链接串起来,让站内的文章互相”托举”。
如果你的主战场之一是公众号,那”Markdown 写完直接搬”基本不现实——微信编辑器不认这套语法。务实的做法是写完后过一道转换工具(比如各类 Markdown 转公众号格式的在线编辑器),把排版一次性刷成微信兼容样式,再粘进后台。多花三分钟,比在公众号编辑器里手动调格式省半小时。
写在最后
很多人问:都 AI 写作时代了,还学 Markdown 干嘛?恰恰相反——当生成内容的成本趋近于零,内容的组织、归档和可迁移性才变成稀缺能力。Markdown 不酷,它只是一堆 .md 文件加几个井号;但十年后你的博客还在、文章还能一键导出、搬家不需要求任何平台,那时候你就知道,当初那几个井号有多值。
写作是把话说明白,Markdown 是让这句话在任何地方都长一个样。你现在写博客用什么工具?踩过排版的坑吗?评论区聊聊。
