1107 字
6 分钟
页面浏览--访问次数--
Markdown 基础语法

段落与换行#

效果

这是第一行文本,行尾加两个空格
这是同一段落内的强制换行。

这是新段落,与上一段之间保留了空行。

源码(注意第一行行尾有 2 个空格)

这是第一行文本,行尾加两个空格
这是同一段落内的强制换行。
这是新段落,与上一段之间保留了空行。

行尾也可以用反斜线 \ 代替两个空格实现强制换行。

标题#

效果

这是三级标题#

这是四级标题#

源码

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

各级标题会自动生成语义锚点并进入右侧目录。

引用块#

效果

这是第一层引用内容。

这是嵌套的第二层引用。

引用内部支持列表与格式化:

  1. 第一项说明
  2. 第二项说明

引用内的行内代码

源码

> 这是第一层引用内容。
>
> > 这是嵌套的第二层引用。
>
> 引用内部支持列表与格式化:
> 1. 第一项说明
> 2. 第二项说明
>
> `引用内的行内代码`

列表#

效果

  • 无序列表项一
  • 无序列表项二
    • 缩进两个空格形成子列表
    • 第二个子列表项
  1. 第一步操作
  2. 第二步操作
  3. 第三步操作

源码

- 无序列表项一
- 无序列表项二
- 缩进两个空格形成子列表
- 第二个子列表项
1. 第一步操作
2. 第二步操作
3. 第三步操作

无序列表的标记符号可以用 -、*、+,官方建议统一使用 -。

任务清单#

效果

  • 已完成的核心配置项
  • 待编写的技术文档章节
  • 待确认的排版细节

源码

- [x] 已完成的核心配置项
- [ ] 待编写的技术文档章节
- [ ] 待确认的排版细节

代码块#

效果

interface SiteConfig {
title: string;
themeColor: number;
}

源码(外层四反引号仅为包裹,实际写三个反引号)

```typescript
interface SiteConfig {
title: string;
themeColor: number;
}
```

除围栏写法外,正文缩进 4 个空格也会成为代码块。

水平分割线#

效果

段落上部内容


段落下部内容

源码

段落上部内容
---
段落下部内容

分割线用 3 个或更多 -、*、_ 都可以。

文本强调#

效果

斜体文本、粗体文本、粗斜体文本、删除线文本、行内代码

源码

*斜体文本*
**粗体文本**
***粗斜体文本***
~~删除线文本~~
`行内代码`

链接#

效果

行内式:链接文字、站内相对路径

参考式:详细规范请参考 官方文档 和 仓库地址。

自动链接:https://shirone.mysqil.com

源码

行内式:[链接文字](https://shirone.mysqil.com/ "可选的悬停提示标题")
参考式:详细规范请参考 [官方文档][docs] 和 [仓库地址][repo]。
自动链接:<https://shirone.mysqil.com>
[docs]: https://shirone.mysqil.com/ "文档站"
[repo]: https://github.com/LyraVoid/Shirone "GitHub"

图片#

效果

示例图片
这是一张示例图片

源码

![图片替代文本](./cover.webp "可选图题")

图片的宽度控制与图题排版在图片画廊与排版一篇里单独演示。

转义字符#

效果

*这不是斜体文本*

[这不是链接]

# 这不是标题

源码

\*这不是斜体文本\*
\[这不是链接\]
\# 这不是标题

可转义的保留符号包括:\、`、*、_、{}、[]、()、#、+、-、.、!。

原生 HTML#

效果

使用 Ctrl + C 复制内容。

居中显示的纯 HTML 说明文本

源码

使用 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制内容。
<div style="text-align: center;">
居中显示的纯 HTML 说明文本
</div>

编辑器快捷键#

排版效果语法格式Windows / LinuxmacOS
粗体**文本**Ctrl + BCommand + B
斜体*文本*Ctrl + ICommand + I
行内代码`代码`Ctrl + Shift + `Command + Shift + `
插入链接[文本](链接)Ctrl + KCommand + K
插入图片![说明](路径)Ctrl + Shift + ICommand + Shift + I

写作注意#

  • 段落之间需一个或更多空行分隔,标记符号与文本之间必须保留空格;
  • 官方建议统一使用 - 与 Atx 井号标题语法;
  • 转义只对保留符号加 \ 生效。

第 1 篇,共 23 篇本文属于系列

Markdown 基础语法
https://www.klucen.cn/posts/博客搭建/markdown-basic/
作者
KLucen
发布于
2025-12-14
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...

最后更新于 ,距今已过 301 天

部分内容可能已过时