Markdown 写作示范封面

Markdown 写作示范:图片、视频、代码块全攻略

概述 这是一篇 Hugo + PaperMod 主题的完整写作示范,展示了所有常用 Markdown 格式的效果。你可以基于此模板改写自己的文章。 文字排版 加粗文字、斜体文字、删除线、行内代码。 这是一段引用块。可以用来强调重要内容,或者引用别人的话。 —— 可以有多行 列表 无序列表: 第一项 第二项 嵌套子项 另一个子项 有序列表: 第一步 第二步 第三步 图片演示 方式一:Markdown 语法 方式二:HTML 精确控制 方式三:PaperMod figure shortcode 湖边风景拍摄于某个周末的下午 代码块 Go 代码 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 package main import "fmt" func main() { fmt.Println("Hello, 小黄!") // 计算斐波那契数列 for i := 0; i < 10; i++ { fmt.Printf("fib(%d) = %d\n", i, fib(i)) } } func fib(n int) int { if n <= 1 { return n } return fib(n-1) + fib(n-2) } Python 代码 1 2 3 4 5 6 7 8 9 10 11 12 13 def quick_sort(arr): """快速排序""" if len(arr) <= 1: return arr pivot = arr[len(arr) // 2] left = [x for x in arr if x < pivot] middle = [x for x in arr if x == pivot] right = [x for x in arr if x > pivot] return quick_sort(left) + middle + quick_sort(right) # 测试 print(quick_sort([3, 6, 8, 10, 1, 2, 1])) # 输出: [1, 1, 2, 3, 6, 8, 10] JavaScript 代码 1 2 3 4 5 6 7 8 9 10 11 12 13 // 防抖函数 function debounce(fn, delay = 300) { let timer = null; return function (...args) { clearTimeout(timer); timer = setTimeout(() => fn.apply(this, args), delay); }; } // 使用示例 const handleSearch = debounce((keyword) => { console.log('搜索:', keyword); }, 500); Shell 命令 1 2 3 4 5 6 7 8 # 部署博客 hugo --minify git add . git commit -m "post: 新文章" git push # 本地预览 hugo server -D 表格 格式 语法 效果 加粗 **文字** 文字 斜体 *文字* 文字 代码 `code` code 链接 [文本](url) 链接 图片 ![alt](url) 显示图片 视频演示 方式一:HTML5 原生视频 您的浏览器不支持 HTML5 视频,请 下载观看。 方式二:B站嵌入 方式三:YouTube 嵌入 提示框 提示:这是一条提示信息,用于补充说明。 ...

September 12, 2026 · 2 min · 小黄
博客搭建指南封面

从零搭建个人博客:Hugo + PaperMod + Cloudflare Pages 完全指南

前言 一直想搭个自己的博客,记录一些技术思考和随笔杂记。要求很简单: 📝 写 Markdown 就行,别折腾 🆓 全程免费,不花一分钱 🚦 推送代码后自动部署 🌙 支持暗黑模式、代码高亮、目录 🏷️ 支持标签、分类、RSS 最终选了 Hugo + PaperMod + Cloudflare Pages + GitHub Actions 这套方案。 整个过程从安装到上线大约 2 小时(主要是踩坑),下面是完整记录。 技术选型 对比了几个主流方案: 框架 构建速度 部署难度 主题生态 推荐度 Hugo ⚡ 极快(Go 二进制) 简单 丰富(300+) ⭐⭐⭐⭐⭐ Astro 快 简单 增长中 ⭐⭐⭐⭐ Hexo 中(Node.js) 简单 丰富 ⭐⭐⭐⭐ Jekyll 慢(Ruby) 简单(GitHub Pages 原生) 丰富 ⭐⭐⭐ Zola 快(Rust) 简单 少 ⭐⭐⭐ 最终选 Hugo:单二进制零依赖,构建秒级完成,PaperMod 主题开箱即用,支持暗黑模式、TOC、代码高亮、RSS 等所有需求。 整体架构 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 ┌─────────────────────────────────────────────────────────┐ │ 你的本地电脑 │ │ │ │ 写 Markdown 文章 → hugo new content/posts/xxx/index.md │ │ ↓ │ │ hugo server -D 本地预览 │ │ ↓ │ │ git add . && git commit && git push │ └─────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────┐ │ GitHub 仓库 │ │ │ │ main 分支 push 触发 GitHub Actions │ └─────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────┐ │ GitHub Actions CI │ │ │ │ 1. checkout 代码(含 submodule) │ │ 2. 安装 Hugo extended │ │ 3. hugo --minify 构建静态资源 │ │ 4. 部署到 Cloudflare Pages │ └─────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────┐ │ Cloudflare Pages │ │ │ │ 全球 CDN 加速,免费 SSL,自动分发 │ │ 访问地址:https://xiaohuang-blog.pages.dev │ └─────────────────────────────────────────────────────────┘ 全程自动化,你只需要 写文章 + push。 ...

September 12, 2026 · 6 min · 小黄

从零搭建个人博客:Hugo + PaperMod + Cloudflare Pages 完全指南

前言 一直想搭个自己的博客,记录一些技术思考和随笔杂记。要求很简单: 📝 写 Markdown 就行,别折腾 🆓 全程免费,不花一分钱 🚀 推送代码后自动部署 🌙 支持暗黑模式、代码高亮、目录 🏷️ 支持标签、分类、RSS 最终选了 Hugo + PaperMod + Cloudflare Pages + GitHub Actions 这套方案。下面是完整过程。 技术选型 对比了几个主流方案: 框架 构建速度 部署难度 主题生态 推荐度 Hugo ⚡ 极快 简单 丰富 ⭐⭐⭐⭐⭐ Astro 快 简单 增长中 ⭐⭐⭐⭐ Hexo 中 简单 丰富 ⭐⭐⭐⭐ Jekyll 慢 简单 丰富 ⭐⭐⭐ 最终选 Hugo:单二进制零依赖,构建秒级完成,PaperMod 主题开箱即用。 整体工作流 1 2 3 4 5 6 7 8 9 10 11 本地写 Markdown 文章 ↓ git push 到 GitHub (main 分支) ↓ GitHub Actions 自动触发 ↓ 构建 Hugo 静态资源 ↓ 自动部署到 Cloudflare Pages ↓ 网站更新完成 ✅ 全程自动化,你只需要写文章 + push。 ...

September 12, 2026 · 3 min · 小黄