分享生活点滴

markdown使用方法

Sat, 06 Jun 2026 00:00:00 GMT

1. 什么是 Markdown#

Markdown 是一种轻量级的标记语言，可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建，如今已成为世界上最受欢迎的标记语言之一。

核心特点：

纯文本，任何编辑器都可打开
语法简单，学习成本低
可轻松转换为 HTML、PDF 等格式
被 GitHub、Notion、Obsidian 等大量平台支持

2. 常用语法速查#

2.1 标题#

代码：

1
# 一级标题
2
## 二级标题
3
### 三级标题

效果：

一级标题#

二级标题#

三级标题#

2.2 强调#

代码：

1
*斜体*  或 _斜体_
2
**粗体** 或 __粗体__
3
***粗斜体***

效果：

斜体或斜体

粗体或粗体

粗斜体

2.3 列表#

无序列表 - 代码：

1
- 项目一
2
- 项目二
3
  - 子项目

无序列表 - 效果：

项目一
项目二
- 子项目

有序列表 - 代码：

1
1. 第一项
2
2. 第二项

有序列表 - 效果：

第一项
第二项

2.4 链接和图片#

代码：

1
[百度](https://www.baidu.com)
2

3
![图片描述](./567cd43873b1c3b76126d05f0c59c8e23546640216492036.jpg)

效果：

百度

图片描述

2.5 代码块#

代码：

1
```python
2
print("Hello Markdown")

1
**效果：**
2

3
```python
4
print("Hello Markdown")

2.6 引用#

代码：

1
> 这是一段引用内容
2
> 可以多行

效果：

这是一段引用内容可以多行

2.7 表格#

代码：

1
| 语法 | 效果 |
2
|------|------|
3
| *斜体* | 倾斜文字 |
4
| **粗体** | 加粗文字 |

效果：

语法	效果
斜体	倾斜文字
粗体	加粗文字

2.8 任务列表#

代码：

1
- [x] 已完成事项
2
- [ ] 未完成事项

效果：

已完成事项
未完成事项

2.9 分隔线#

代码：

1
---

效果：

3. Markdown 扩展功能：Expressive Code#

基础的代码块展示能力有限。借助 Expressive Code 这类工具，你可以创建专业级的代码示例，包括编辑器外观、终端外观、行标记、文本高亮、代码折叠等功能。

Expressive Code 适用于 Astro、Starlight、VitePress 等现代静态站点生成器。

3.1 模拟编辑器框架#

通过 frame="editor" 属性，让代码块显示为代码编辑器外观，并支持自定义文件标题。

代码：

my-test-file.js

1
console.log('标题属性示例');

效果：

my-test-file.js

1
console.log('标题属性示例');

3.2 模拟终端框架#

通过 frame="terminal" 属性，让代码块显示为终端窗口外观。

代码：

PowerShell 终端示例

1
Write-Output "这个有标题!"

效果：

PowerShell 终端示例

1
Write-Output "这个有标题!"

不设标题的终端：

Terminal window

1
echo "此终端框架没有标题"

3.3 覆盖框架类型#

使用 frame="none" 可以移除框架，只显示纯代码块。

代码：

1
console.log('看，没有框架！');

效果：

1
console.log('看，没有框架！');

3.4 标记整行或行范围#

使用 mark、ins（插入）、del（删除）等属性来高亮指定行。

代码：

1
// 第1行 - 通过行号定位
2
// 第2行 - 此行标记为删除
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行 - 此行标记为插入

效果：

1
// 第1行 - 通过行号定位
2
// 第2行 - 此行标记为删除
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行 - 此行标记为插入

标记行范围：

1
// 第1行 - 通过行号定位
2
// 第2行 - 此行标记为删除
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行 - 范围 "5-6" 标记为插入
6
// 第6行 - 范围 "5-6" 标记为插入

3.5 为行标记添加标签#

使用 mark 属性时，可以同时添加自定义标签文字。

代码：

1
// 这一行会有一个"可折叠"标签
2
// 这一行没有标签
3
console.log('正常工作');

3.6 使用类似 Diff 的语法#

使用 + 和 - 符号直观标记新增或删除的行。

代码：

1
此行将标记为已删除
2
此行将标记为已插入
3
这是常规行

效果：

1
此行将标记为已删除
2
此行将标记为已插入
3
这是常规行

结合语法高亮：

1
// 整个块都会以 JavaScript 高亮显示
2
- console.log('要删除的旧代码');
3
+ console.log('新的闪亮代码！');

3.7 标记行内的单独文本#

使用 mark 属性配合正则表达式，高亮行内的特定单词。

代码：

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

效果：

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

3.8 自动换行#

使用 wrap 属性控制长代码是否自动换行。

开启换行（wrap=true）：

1
// 这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间';
4
}

关闭换行（wrap=false）：

1
// 这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间';
4
}

3.9 可折叠部分#

使用 collapse 属性将长代码或样板代码折叠起来。

代码：

可折叠的样板代码展开收起

1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate';
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate';
4

5
// 直到块末尾的所有代码将再次被折叠
6
function main() {
7
  console.log('实际业务代码');
8
}

展开收起

效果：

可折叠的样板代码展开收起

1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate';
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate';
4

5
// 直到块末尾的所有代码将再次被折叠
6
function main() {
7
  console.log('实际业务代码');
8
}

展开收起

3.10 显示行号#

使用 showLineNumbers 属性开启行号显示。

代码：

1
// 此代码块将显示行号
2
console.log('来自第2行的问候！');
3
console.log('我在第3行');

效果：

1
// 此代码块将显示行号
2
console.log('来自第2行的问候！');
3
console.log('我在第3行');

更改起始行号：

1
// 此行显示为第5行
2
console.log('来自第6行的问候！');

3.11 如何启用 Expressive Code#

Expressive Code 是 Astro 生态的插件。如果你的博客基于 Astro 或 Starlight，可以按以下步骤集成：

1. 安装：

Terminal window

1
npm install expressive-code

2. 配置（astro.config.mjs）：

1
import { defineConfig } from 'astro/config';
2
import expressiveCode from 'expressive-code';
3

4
export default defineConfig({
5
  integrations: [expressiveCode()],
6
});

3. 使用：

之后在 Markdown 或 MDX 文件中，即可通过上述语法使用所有功能。

更详细的安装与配置选项，建议查阅 Expressive Code 官方文档。

4. 小贴士#

场景	建议
写教程	代码块 + 实际效果对比展示
记笔记	多用列表和标题，少用复杂格式
写博客	善用引用块突出金句
团队文档	统一代码块语言标识

5. 写在最后#

掌握 Markdown 不需要背语法，用的时候查一下，一周左右就能形成肌肉记忆。

推荐练习方式：每天用 Markdown 写一篇短笔记，一周即可熟练。

参考资料#

Markdown 基础语法#

本文中 Markdown 基础语法部分参考自以下官方文档和资料：

Microsoft Learn - Markdown 是什么？
- 说明：Markdown 基础语法官方教程，涵盖标题、强调、列表、链接、代码块、表格、任务列表等
- 链接：https://learn.microsoft.com/zh-cn/training/modules/communicate-using-markdown/2-what-is-markdown
Microsoft Learn - Markdown 最佳做法
- 说明：Markdown 编写规范与最佳实践，包括标题规则、列表格式、链接规范等
- 链接：https://learn.microsoft.com/zh-cn/powershell/scripting/community/contributing/general-markdown
阿里云文档中心 - Markdown 使用指南
- 说明：Markdown 基本语法与使用示例，包含标题、强调、列表、链接、图片、表格、任务列表等
- 链接：https://help.aliyun.com/zh/mobi/markdown-usage-guide
阿里云开发者社区 - MarkDown 语法手册
- 说明：完整的 Markdown 语法整理，涵盖斜体粗体、标题、超链接、锚点、列表、引用、代码等
- 链接：https://developer.aliyun.com/article/75499
腾讯云开发者社区 - Markdown简要语法规则
- 说明：Markdown 常用语法速查
- 链接：https://cloud.tencent.cn/developer/article/2563180
百度开发者中心 - Markdown中如何添加参考文献和引用
- 说明：Markdown 中添加引用和参考文献的方法
- 链接：https://developer.baidu.com/article/details/2970779

Expressive Code 扩展功能#

本文中 Expressive Code 部分参考自以下官方文档：

Expressive Code 官方文档 - Text & Line Markers
- 说明：行标记与文本标记功能的详细用法
- 链接：https://expressive-code.com/key-features/text-markers/
Expressive Code 官方文档 - Editor & Terminal Frames
- 说明：编辑器框架与终端框架功能的详细用法
- 链接：https://expressive-code.com/key-features/frames/
Expressive Code 官方文档 - Configuration
- 说明：配置 Expressive Code 的方式与选项
- 链接：https://expressive-code.com/reference/configuration/
Expressive Code GitHub 仓库
- 说明：项目源码、贡献指南、包结构说明
- 链接：https://github.com/expressive-code/expressive-code
@expressive-code/core - npm 包
- 说明：Expressive Code 核心引擎的安装与使用示例
- 链接：https://www.npmjs.com/package/@expressive-code/core

扩展阅读#

Expressive Code 官方文档首页：https://expressive-code.com/
Astro 集成文档：https://docs.astro.build/en/guides/integrations-guide/expressive-code/
《了不起的 Markdown》- 毕小朋著，电子工业出版社，2025
- 说明：Markdown 标准语法与扩展技巧，从基础写作到智能知识管理的完整指南

END#

感谢您的阅读！

手把手部署宝塔面板

Wed, 03 Jun 2026 01:07:30 GMT

前言#

本文将指导您如何在 Linux 服务器上部署宝塔面板。

本次使用的设备：一台 Windows 11 电脑，一台 56 核 64GB 的标准机架式服务器。
您也可以使用其他设备进行操作。

前提条件#

服务器上未安装任何 Web 环境，为纯净系统。
服务器可以正常连接互联网。

操作步骤#

第一种方法：通过 SSH 手动执行安装命令#

使用 SSH 登录服务器
这里使用 Windows 自带的 OpenSSH，你也可以使用其他 SSH 软件。

OpenSSH 登录界面
确认密钥指纹并输入密码
如果出现以下提示，输入 yes 并回车。

确认密钥指纹

然后输入服务器密码（输入时不会显示字符）。

输入密码
获取宝塔面板安装命令
在浏览器中搜索“宝塔面板”或“btpanel”，进入官网（域名 bt.cn），点击“立即免费安装宝塔面板”。

浏览器搜索宝塔面板

宝塔面板官网1

宝塔面板官网2

跳转到“安装宝塔Linux面板”页面后，选择对应的 Linux 系统，点击复制命令（通用脚本即可）。

复制安装命令
安装必要工具（如缺少 wget/curl）
如果你的服务器缺少 wget 或 curl，先执行： apt update && apt install -y wget
安装所需工具
粘贴并执行安装命令
将上一步复制的安装命令粘贴到终端中，按回车执行。

粘贴安装命令
等待安装
安装过程中如果提示 Do you want to install Bt-Panel to the /www directory now?(y/n)，输入 y 继续。

安装过程1

安装过程2

耐心等待安装完成。

登录宝塔面板
安装完成后，终端会显示面板的外网/内网访问地址（包含 IPv4/IPv6 地址）。选择公网地址打开。

面板登录界面

输入初始用户名和密码，阅读并同意《用户协议》，进入面板首页。

登录后界面1

登录后界面2

绑定宝塔账户（可选）后即可使用。

面板首页

第一种方法到此结束

第二种方法：使用宝塔面板在线安装工具#

进入在线安装页面
在宝塔官网的安装页面下滑，找到“Linux面板在线安装”。

在线安装1
填写服务器信息

输入服务器的公网 IP（不能是内网 IP）。
输入 root 密码。
SSH 端口默认为 22。

选择“仅面板”，点击“安装”。

在线安装2

等待自动安装
如果 SSH 连接成功，会开始自动安装。稍等片刻。

自动安装过程
获取面板信息
安装完成后，页面会自动显示面板的访问地址、用户名和密码。复制保存。

安装完成信息
登录面板
访问面板地址，输入用户名和密码，同意协议后即可进入首页。

登录后界面1

登录后界面2

绑定宝塔账户（可选）后即可使用。

面板首页

安装后的建议#

进入面板后，会提示安装基础环境。推荐选择 LNMP，你也可以跳过此步骤，稍后在“软件商店”中自行安装。
建议前往面板设置中修改默认的面板账号和密码，提高安全性。

至此，宝塔面板已成功安装。

END#

部分素材录制时间不同，可能存在细节差异，欢迎指正！
感谢您的阅读。

引用#

请输入文本

Wed, 03 Jun 2026 00:00:00 GMT

请输入文本#

请输入文本 请输入文本 请输入文本

END#

谢谢您的阅读！

Hello! World!

Sun, 31 May 2026 00:00:00 GMT

这是小高拐拐の博客的第一篇文章，主要是用来熟悉markdown语法、写文章、发布文章等程序

文章的 Front-matter#

1
---
2
title: 我的第一篇博客文章
3
published: 2026/05/31
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./X0_6rTZl.jpeg
6
tags: [Markdown]
7
category: Markdown
8
draft: false
9
---

免责声明#

此文章仅做首篇测试，不包含任何实际内容，谢谢理解

END#

感谢您的阅读