怎么用Markdown编写博客

一、为什么选择 Markdown 写博客？

简单易学：语法非常直观，几分钟就能上手。
纯文本：兼容性极强，可以用任何文本编辑器打开，永远不会过时。
专注内容：让你摆脱繁琐的格式按钮，纯粹地写作。
轻松转换：可以轻松转换为 HTML、PDF、Word 等多种格式。
广泛支持：几乎所有静态博客生成器（如 Hexo, Jekyll, Hugo）和内容平台（如 GitHub, GitLab, 知乎、语雀）都完美支持

二、Markdown基本语法（博客常用）

__以下是你写博客时最常用到的核心语法：__

标题用#的数量来表示不同级别的标题。
一级标题 (博客标题)

二级标题 (主要章节标题)

三级标题 (子章节标题)

四级标题

段落和换行段落：直接敲回车换行是无效的。要创建新段落，需要在两个段落之间空一行。
换行：在当前行末尾输入两个空格再回车，可以实现段内换行。
强调这是斜体的文字。
这是_斜体_ 的文字。
这是粗体的文字。
这是__粗体__ 的文字。
这是___粗斜体___的文字
列表
有序列表：
1.第一项
2.第二项
3.第三项
__无序列表__（用 -, +, *都可以）：
-项目一
-项目二
-子项目（通过两个空格或一个制表符缩进）
-项目三
链接和图片
__链接：__
链接文字：北京美景宏图
__图片：__

注意：
Markdown 本身不存储图片。如果图片在本地，你需要设置好相对路径或绝对路径。很多博客平台允许你直接拖拽上传图片，并自动生成 Markdown 代码。

代码
行内代码：用反引号包裹。
使用 printf() 函数来打印输出。
代码块：用三个反引号 `` 包裹，并可以指定语言以实现语法高亮。

def hello_world():
    print("Hello, World!")

const router = createRouter({
    history:createWebHistory(import.meta.env.BASE_URL),
    routes:[
        {path:'/',component:()=>import('~/views/Layout/index.vue'),
            children:[
                {path:'',component:()=>import('~/views/Home/index.vue')},
                {path:'category',component:()=>import('~/views/Category/index.vue')},
                {path:'about',component:()=>import('~/views/About/index.vue')},
                {path:'login',component:()=>import('~/views/Login/index.vue'),meta:{isAuth:true}},
            ]
        },
    ]
})

def generate_htmls():
    out_dir = Path('static/html')
    out_dir.mkdir(parents=True,exist_ok=True)
    html = htmls.get_template('pc/index.html').render()
    out_path = out_dir/'index.html'
    out_path.write_text(html,encoding="utf-8")
    return '生成静态页面成功'

引用 > 这是一个引用块。
> 引用可以有多行。
> 结合文件监听（自动更新 JSON） > > 甚至还可以嵌套。
> > 安装 watchdog

分割线
使用三个或以上的 *, -, 或 _来创建一条分割线。

表格

左对齐	居中对齐	右对齐
单元格	单元格	单元格
单元格	单元格	单元格

:的位置决定了对齐方式。

三、博客文章结构示例

一个典型的博客 .md文件结构如下：

title: 你的博客标题 date: 2023-10-27 author: 你的名字 tags: [Markdown, 教程, 博客]

categories: 技术

为什么我选择用 Markdown 写博客

前言

今天我想分享一下我最近发现的高效写作工具 —— Markdown...

Markdown 的优点

1. 极简高效

专注于内容：不再需要频繁地用鼠标去点击格式按钮...
纯文本优势：...

2. 通用性强

看看这段代码是如何高亮的：

print("Hello, Markdown!")

如何开始？

选择一个编辑器：比如 VS Code, Typora 等。
学习基本语法：就像这篇博客里介绍的一样。
开始写作！

总结

总而言之，Markdown 是一个... [引用一位大师的话]：

Simplicity is the ultimate sophistication. — Leonardo da Vinci

发布时间：{ { page.date } }

注意：开头的 ---之间的部分叫做 Front Matter。这是许多静态博客生成器（如 Jekyll, Hexo, Hugo）用来定义文章元数据（标题、日期、标签、分类等）的格式。不是标准 Markdown 语法，但极其重要。

四、工具推荐

编辑器：

VS Code 功能强大的免费代码编辑器，有大量 Markdown 插件（如 Markdown All in One, Paste Image用于粘贴图片）。

Typora：极致简洁的“所见即所得”编辑器，付费但体验极佳。

Obsidian：基于 Markdown 的知识库管理工具，适合写系列博客。

图床：为了解决本地图片路径问题，建议使用图床（专门存储图片的云服务）。你只需将图片上传到图床，它会给你一个永久链接，然后你在 Markdown 里使用这个图片链接即可。

PicGo: 一个免费的桌面应用，可以方便地上传图片到各大图床（如 GitHub, 阿里云 OSS, 腾讯云 COS 等），并自动将链接复制到剪贴板。

博客平台：静态博客生成器：将 .md文件生成静态网站。最流行的有 Hexo, Jekyll, Hugo。它们通常与 GitHub Pages 或 Vercel 等免费服务搭配使用。

支持 Markdown 的传统平台：如 WordPress（需安装插件）、语雀、Notion 等。

五、工作流程建议

在本地用你喜欢的编辑器写好 .md文件。
文中的图片通过 PicGo 等工具上传到图床，并插入链接。
将 .md文件推送到你的代码仓库（如 GitHub）。
静态博客生成器（如 Hexo）会自动将其编译成 HTML 页面并部署。
访问你的博客网站，查看新文章！

希望这个指南能帮助你顺利开始用 Markdown 创作博客！祝你写作愉快！