学习Markdown

发表于 | 分类于 | 浏览 次
字数统计: 1.2k | 阅读时长 ≈ 4

1. 简介

Markdown是一种轻量级标记语言，它用简洁的语法代替排版。它的目的是实现易读易写，成为一种适用于网络的书写语言。同时，Markdown支持嵌入html标签。

注意：Markdown使用#、+、*等符号来标记，符号后面必须跟上至少一个空格才有效！

1.1. 标题

在标题前面加上1~6个#，依次表示一级标题，二级标题…六级标题

一级标题

二级标题

三级标题

六级标题

1.2. 列表

Markdown支持有序列表和无序列表
无序列表使用-、+、和*作为列表标记
使用-作为列表标记

  • Red
  • Green
  • Blue
    使用+作为列表标记
  • Red
  • Green
  • Blue
    使用*作为列表标记
  • Red
  • Green
  • Blue
    有序列表使用数组加英文句点.来表示
  1. Red
  2. Green
  3. Blue

1.3. 引用

引用用>来表示，引用支持多级引用，标题，列表，代码块，分割线等常规语法。
常见的引用写法：

这是一段应用 //在>后面有1个空格

这是引用的代码块形式  // 在>后面有5个空格

代码例子：

1
2
3
4
protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);
    }

一级引用

二级引用

三级引用

  1. 这是第一行列表项
  2. 这是第二行列表项

1.4. 强调

两个或_代表加粗，一个 或者_代表斜体，代表删除
加粗文本 或者
加粗文本
斜体文本 或者
_斜体文本_
~~删除文本

1.5. 图像与链接

图片与链接的语法很像，区别在于一个!,二者格式：

图片： 图像文本(可忽略)

Markdown

在博客中插入本地图片

1.修改配置文件_config.yml 里的post_asset_folder:这个选项设置为true
2.在你的hexo目录下执行这样一句话npm install hexo-asset-image —save，这是下载安装一个可以上传本地图片的插件，来自dalao：dalao的git（未验证有什么用）
3.等待一小段时间后，再运行hexo n “xxxx”来生成md博文时，/source/_posts文件夹内除了xxxx.md文件还有一个同名的文件夹
4.最后在xxxx.md中想引入图片时，先把图片复制到xxxx这个文件夹中，然后只需要在xxxx.md中按照markdown的格式引入图片：

输入![你想输入的替代文字]和(xxxx/图片名.jpg)

注意

  • 导入的图片路径可以使用绝对路径也可以使用相对路径，建议使用相对路径。
  • 通常的做法是Markdown文档的同级目录下建立一个pictures文件夹，里面放置所有所需的图片，如果图片多的话，你也可以在pictures文件夹里建立子文件夹归类。
  • 如果你的markdown在一个文件目录下，需要添加另一个目录下的图片，绝对路径是不可行的。需要 “迂回”
    所谓 迂回，即需要先用../../命令返回上一文件目录，直至可以顺利找到要添加图片的目录。
    举个栗子:
    比如你的markdown在~/Document/mymarkdown/test下，需要添加~/Downloads/Pic/background目录下的sunlight.jpg
    你需要做的是:先写![]，再加上(../../../Downloads/Pic/background/sunlight.jpg)

链接： 链接文本
百度

1.6. 代码

代码分为行内代码和代码块

  • 行内代码使用代码标识，可嵌入文本中
  • 代码块使用4个空格，或者
    1
    2


这里是代码

1
2
3
4
5
6
7
8

+ 代码语法高亮在```后面加上空格和语言名称即可

``` java
protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);
}

2. 表格

表格对齐方式

  • 居左：:——
  • 居中：:——:或——-
  • 居右：——:
    例子

    |标题1|标题2|标题3|
    |:—-|:—-:|—-:|
    |居左文本1|居中文本1|居右文本1|
    |居左文本2|居中文本2|居右文本2|
    |居左文本3|居中文本3|居右文本3|
    表头1 | 表头2
    ————|———
    内容1 | 内容2
    内容3 | 内容3

2.1. 分割线

在一行中用三个以上的*、-、_、来建立一个分割线，行内不能有东西，也可以在行内插入空格

*

2.2. 换行

在行尾添加两个空格加回车表示换行

3. 常用弥补Markdown的html标签

3.1. 字体

字体及字体颜色和大小 字体颜色

3.2. 换行

使用html标签<br/>
换行

3.3. 文本对其方式

居左文本

居中文本

居右文本

3.4. 下划线

下划线文本

打赏
0%