markdown写作常用标识

发表于 | 分类于
字数统计: 9.1k

📋 知识地图

说明：✅ = 已有覆盖（可继续深化）　⬜ = 待扩充

一、基础语法（已全覆盖）

  • ✅ 标题（# 1-6级 / === / —）
  • ✅ 段落与换行
  • ✅ 字体效果（斜体 / 粗体 / 粗斜体）
  • ✅ 分割线
  • ✅ 删除线与下划线
  • ✅ 脚注
  • ✅ 有序列表与无序列表（含嵌套）
  • ✅ 区块引用（>）
  • ✅ 代码片段与代码块（含语言标注）
  • ✅ 外部链接与图片
  • ✅ 表格（含对齐与宽度控制）
  • ✅ 转义符（\）
  • ✅ HTML 隐藏注释
  • ✅ 锚点跳转（本文内 / 站内文章）

二、Markdown 扩展语法

  • ⬜ 任务列表（- [ ] / - [x]）
  • ⬜ Mermaid 图表（流程图 / 时序图 / 甘特图）
  • ⬜ 数学公式（LaTeX / MathJax）
  • ⬜ 上标 / 下标（^ / ~）
  • ⬜ 定义列表（dt / dd）
  • ⬜ 缩写（abbr）
  • ⬜ Emoji 表情代码

三、Markdown 方言与兼容性

  • ⬜ CommonMark 标准规范
  • ⬜ GitHub Flavored Markdown（GFM）扩展
  • ⬜ 不同平台渲染差异（GitHub / 知乎 / 简书 / 语雀）
  • ⬜ Markdown 预处理工具（marked / markdown-it）

四、Hexo 博客写作深度集成

  • ✅ Hexo 内部链接（post_link / post_path）
  • ⬜ Hexo 标签插件大全（blockquote / code / note / iframe 等）
  • ⬜ Front-matter 完整字段（title / date / categories / tags / top / toc / comments）
  • ⬜ Hexo 文章草稿（draft）与发布工作流
  • ⬜ 批量导入外部内容到 Hexo
  • ⬜ Hexo 主题对 Markdown 的特殊支持

五、Markdown 编辑器与工具链

  • ⬜ VS Code Markdown 插件（Markdown All in One / markdownlint / Mermaid 支持）
  • ⬜ Typora / Obsidian / Notion 等编辑器对比
  • ⬜ Markdown 预览与热更新
  • ⬜ Pandoc 格式转换（md → docx / pdf / html / epub）

六、写作规范与最佳实践

  • ⬜ 中文文案排版规范（空格 / 标点 / 中英文混排）
  • ⬜ 技术文档写作结构（概述 → 前置 → 正文 → 总结）
  • ⬜ markdownlint 规则配置
  • ⬜ 图片管理策略（本地 / 图床 / CDN）
  • ⬜ 文章 SEO 优化（标题 / 描述 / 关键词）

七、自动化与 CI/CD

  • ⬜ GitHub Actions 自动部署 Hexo
  • ⬜ 文章质量检查（拼写 / 链接有效性 / 格式规范）
  • ⬜ RSS 订阅生成与推送

八、高级主题

  • ⬜ 自定义 Hexo 渲染引擎
  • ⬜ Markdown 转静态页面原理
  • ⬜ 整站搜索集成（基于 Markdown 内容）

因为hexo下采用markdown排版进行写作，为了方便练习markdown写作，在这里记录写作中常用的markdown标识排版。

一、使用#标记标题

使用#的数量可标识1-6级的标题
其他，可使用一行（多个=或-）分别标识一级标题和二级标题。

二、切换段落

markdown没有段落符号，可使用空行或在末尾添加两个空格来换段落。

三、添加粗体等字体效果

可以分别用一个、两个以及三个*或_标识符框住文字前后，来为文字添加斜体、粗体、粗斜体效果。

四、建立分割线

使用三个以上的*、-建立分割线

五、删除线

使用两个波浪线~~框住文字前后，产生删除线。

六、下划线

通过使用html中的<u>包裹，来产生下划线。

七、使用脚注

脚注或者备注，以[^注明文本]并在次行使用[^注明文本]: 注明内容来标识。
如 但使龙城飞将在，不教胡马度阴山。[^龙城]
[^龙城]: 龙城是哪，我也不知道，者只是一个示例

八、使用列表

支持有序列表和无序列表

有序列表

有序列表使用多行单个*或+来形成

无序列表

无序列表使用数字加点就行。而列表中的镶套，只需要在次级列表中前方添加四个空格。
例如：

1.有序列表一
- 无序列表一
- 无序列表二
2.有序列表二
- 无序列表三
- 无序列表四

九、生成区块

即产生如用引用文字的效果。区块使用>生成，且可根据符号数量镶套。

区块一
区块一

区块二区块二

十、代码区块

代码片段标识

可以使用反引号（英文输入法下，键盘左上角）标识片段代码。

代码区块标识

代码区块可以使用两种方法。一种是使用连续三个反引号包裹代码区块。另一种是通过在代码区块前方添加四个空格。

1
2
3
$(document).ready(function () {
    alert('RUNOOB');
});

十一、外部链接

使用格式为：[链接名称](链接地址) 或 <链接地址>
这是一个链接 菜鸟教程

十二、插入图片

插入图片的方法为：

1
2
3
![alt 属性文本](图片地址)
或
![alt 属性文本](图片地址 "可选标题")

十三、使用表格

使用如下标识代码：

1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

生成效果如下：

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

注意：表格上一行要空一行。

1
2
3
4
5
6
7
8
强制列表宽度
<style>
table th:first-of-type {  //可用th:nth-of-type(1)表示
    /*margin: auto;*/
    /*text-align: center;*/
    width: 30%;
}
</style>

十四、转移符号

\

使用反斜杠。

十五、其他高级使用技巧

请访问markdown高级技巧页面查看。

十六、跳转到本站或本文其他锚点

例如跳转到第二个一级标题（#）

跳转到第二个一级标题“二、切换段落”处

跳转到站内其他文章页面：

1
{% post_link 文章文件名（不要后缀） 文章标题（可选） %}

例如跳转到御坂关于页面

站内其他文章锚点如：

1
[外部显示文字]({% post_path '文章文件名' %}#某级标题)
-------------本文结束感谢您的阅读-------------