Loading

markdown语法总结

前言

笔记梳理:对常用Markdown语法]的进行了简单归纳。本文章归纳过于粗暴仅作参考。

内容基本参考自:Markdown官方教程


1.Markdown是什么?

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

  • 专注于文字内容
  • 纯文本,易读易写,可以方便地纳入版本控制
  • 语法简单,能轻松在码字的同时做出美观大方的排版

2.为什么使用Markdown?

本人最开始接触Markdown主要是代码项目中的README文件,之后用于博客文章撰写。
理由如下:

  • 开源项目广泛使用,追随主流
  • 纯文本文件,独立平台,可以被任何程序打开
  • 基于web设计,博客文章写作需要

3.基本语法

元素 语法 元素 语法
标题 # H1 无序列表 - First item
粗体 ** bold text ** 代码 ` code `
斜体 *italicized text* 分割号 ---
引用块 > blockquote 链接 [title](https:://www.example.com "title")
有序列表 1. First item 图片 ![alt text](image.jpg)
|syntax|Description| 标题编号 ### Heading
表格 |-------|------------| 定义列表 term
|header| title | : definition
代码块 ```
````
删除线 ~~ text ~~
脚注 hello world.[^1] 任务列表 - [ ] title
[^1]:description -[ x] title
注:
  • 代码语法为单引号,代码块语法为三重单引号
  • 文章基于Markdown编辑器书写,即时渲染
  • 其它位置出现单引号皆为使用代码语法保持文章显示正确
  • Markdown语法支持HTML语法,原生不支持功能,可用HTML拓展

基本事项

  • 在文本下方添加任意数量的 == 号来标识一级标题,或者 -- 号来标识二级标题
  • 使用空白行创建段落,不使用空格或制表符Tab缩进段落
  • 在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行
  • 换行语法受兼容性限制,部分可以直接回车换行
  • 将单词或短语的中间部分加粗或设为斜体显示使使用星号
  • 块引用中的空白行同样需要加(>)
  • 嵌套使用块引用(>>)
  • 缩进一个或多个列表项可创建嵌套列表
  • 要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符
  • 代码块放在列表中时缩进八个空格或两个制表符
  • 使用尖括号(<>)将URL或email地址变成可点击的链接

引用

引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。
引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接
注:可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。
引用类型链接的第二部分使用以下属性设置格式:

  1. 放在括号中的标签,其后紧跟一个冒号和至少一个空格([label]: )
  2. 链接的URL,可以选择将其括在尖括号中
  3. 链接的可选标题,可以将其括在双引号,单引号或括号中
[link title][1]

[1]: <url>

表格

使用(|)来分隔不同的单元格,使用(-)来分隔表头和其他行
注:
(-😃——设置内容和标题栏居右对齐。
(😃——设置内容和标题栏居左对齐。
(:-😃——设置内容和标题栏居中对齐。

emoji表情

可以在markdown添加emoji表情(很有趣不是吗)
Markdown语法格式:

:表情名称:

emoji表情简表

特殊字符

版权 (©) — ©
注册商标 (®) — ®
商标 (™) — ™
欧元 (€) — €
左箭头 (←) — ←
上箭头 (↑) — ↑
右箭头 (→) — →
下箭头 (↓) — ↓
度数 (°) — °
圆周率 (π) — π


posted @ 2025-05-31 20:44  Noxryn  阅读(30)  评论(0)    收藏  举报