手把手教你写脚本：Markdown自动转HTML，静态博客发布全流程

大家好，欢迎来到IT知识分享网。

静态博客这两年越来越火，尤其是技术博主圈子里，用Markdown写文章然后一键发布成网页的 workflow 已经成了标配。今天咱们就拆解一套完整方案，从本地写作到自动部署，全程代码可控，还不用花一分钱服务器成本。

为什么静态博客值得折腾？

首先得说清楚，为啥放着WordPress这种现成的不用，非要自己搭静态博客。最大的好处就是快——纯HTML页面加载速度比动态博客快3-5倍，Google PageSpeed评分轻松上90。其次是稳，没有数据库和后台，被攻击的风险几乎为零。像知名技术博主Sannaha的博客就是用Jekyll+GitHub Pages搭建的，跑了三年零故障，访问量上去了也不用扩容服务器（案例来源：
https://blog.csdn.net/gitblog_00077/article/details/）。

工具选择：三行命令搞定环境

市面上能把Markdown转HTML的工具少说有二十种，咱们挑最实用的三种场景：

1. 本地快速预览：Python一行脚本

如果只是想本地看看效果，用Python的markdown库最方便。先装库：

pip install markdown

然后写个极简脚本md2html.py：

import markdown
with open('article.md', 'r', encoding='utf-8') as f:
    html = markdown.markdown(f.read(), extensions=['fenced_code', 'tables'])
with open('article.html', 'w', encoding='utf-8') as f:
    f.write(html)

执行python md2html.py，瞬间生成带代码高亮的HTML文件。

2. 批量处理：Shell脚本自动化

要是文章多了，用Shell脚本批量转换更高效。比如用经典的Markdown.pl工具：

#!/bin/bash
for file in *.md; do
    filename=${file%.md}
    /usr/local/bin/Markdown.pl --html4tags "$file" > "${filename}.html"
done

保存成batch_convert.sh，加执行权限后运行，当前目录所有.md文件会自动转成HTML（案例来源：
https://blog.csdn.net/huolinliang/article/details/）。

自动部署：GitHub Actions全流程

光本地转换还不够，咱们要的是写完push就发布。用GitHub Actions实现这一步，配置文件
.github/workflows/deploy.yml这样写：

name: 静态博客自动部署
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 设置Python环境
        uses: actions/setup-python@v5
        with:
          python-version: "3.10"
      - name: 安装依赖
        run: pip install markdown
      - name: 转换Markdown
        run: python md2html.py
      - name: 部署到GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./html_output

把这个文件放进仓库，每次push代码，GitHub会自动帮你跑脚本、生成HTML并部署到Pages服务，全程不用登录服务器。

真实案例：从写作到上线只要5分钟

开发者JeffyLu的博客就是这套流程的典型案例。他用VS Code写Markdown，配置了两个关键工具： 1. Paste Image插件：截图后按Ctrl+Alt+V自动保存到img目录并插入Markdown链接 2. GitHub Actions钩子：push时触发Python脚本批量转换，再用rsync同步到VPS

现在他的博客更新频率从每月2篇提升到每周5篇，因为整个发布流程从原来的20分钟压缩到了30秒（案例来源：
https://blog.csdn.net/gitblog_00016/article/details/）。

避坑指南：新手常踩的三个坑

1. 图片路径问题：本地预览正常，部署后图片404？解决办法是用相对路径，并在GitHub Pages设置自定义域名。
2. 代码高亮失效：Python脚本记得加extensions=[‘fenced_code’]参数，否则代码块没样式。
3. 部署权限错误：GitHub Actions提示403？去仓库Settings→Secrets添加GH_TOKEN，勾选repo权限。

最后咱们总结一下

这套方案的核心就是用脚本解放双手，用自动化保证效率。从技术选型到实际部署，全程可控且免费。如果你是技术博主，现在就可以： 1. 用VS Code+Markdown All in One插件写文章 2. 选Python/Shell/Node.js任一脚本做转换 3. 配置GitHub Actions实现自动部署 4. 参考Sannaha的项目结构优化SEO（
https://github.com/Sannaha/Sannaha.github.io）

按这个流程走，原本需要手动操作的发布环节，现在全部交给机器处理，你只需要专注写内容。这大概就是技术的魅力——用代码把重复工作干掉，腾出时间做更有价值的事。

（注：文中案例及代码均来自开源项目及技术博客，已注明出处，遵循MIT许可协议。）