markdown的使用

markdown基础语法

1.标题

书写方式:###### + 空格 + 内容 一共6级

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
超大标题     //等于号写在文字下方
===
大标题     //减号写在文字下方
---

效果:

一级标题

二级标题

三级标题

四级标题

超大标题 //等于号写在文字下方

大标题 //减号写在文字下方

2. 列表

a) 无序列表

书写方式:*-+ + 空格 + 内容

* one
* two
* three

效果:(三种效果一样)

  • one
  • two
  • Three

b) 有序列表

书写方式:数字 + . + 空格 + 内容

1. one
2. two
3. three

效果:第一个序号需要手输,之后的会自动加起

  1. one
  2. two
  3. Three

3. 目录

书写方式:[toc]

[toc]

效果(有些编辑器不支持):

[TOC]

4. 分割线

书写方式:***\n +> + \n

效果:


5. 强调(加粗,斜体)

书写方式:*内容***内容**_内容___内容__

*内容*
**内容**
_内容_
__内容__

效果:

内容
内容
内容
内容

6. 引用

书写方式:>> > + 空格 + 内容

a) 单次引用

> 2>1这是常识
不是吗?  //第二行不必再写>

效果:

2>1这是常识
不是吗? //第二行不必再写>

b) 叠层引用

> 鲁迅说过
>> 我什么都没说

效果:

鲁迅说过

我什么都没说

7. 代码引用

a) 行内代码

书写方式:反斜杠 + 内容 + 反斜杠

`hello world`

效果:

hello world

b) 代码块

书写方式:三个反斜杠 + 回车 + 内容

​```
public void main (object[] args){
    
}

效果:

public void main (object[] args){
    
}

8.表格

书写方式:

|Here  |Is   |Table   |
|---   |---  |---     |
|col1  |     |        |
|col2  |     |        |

效果:

Here Is Table
col1
col2

当然,如果实用编辑器的话,是不需要这样手敲的。比如我使用的编辑器插入表格就是command+T

9. 超链接

书写方式:[title](href)

[百度](http://www.baidu.com)

效果:

百度

同时,可以用变量的方式定义超链接

书写方式:[var_name]:url "title"

[id]:http://www.baidu.com "这是百度"
[百度][id]

效果:

百度

简单的超链接

<http://www.baidu.com>

效果:

http://www.baidu.com

简单的email地址

<aaaa@163.com>

效果:

aaaa@163.com

10. 图片引用

书写方式:![alt](图片路径)

![这是图片](http://upload-images.jianshu.io/upload_images/11745649-321799428c0b2626.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果:

这是图片

同样,图片和超链接一样都可以设置变量。

图片路径有三种

  1. 本地路径(绝对路径和相对路径都可以)
  2. 网络链接
  3. base64码

markdown图片处理

​ 由于markdown中的图片处理起来比较麻烦,不如其他软件中那么方便,这里就详细介绍下。

1. 本地路径

​ 这种情况下,推荐使用相对路径,因为当你发文档给别人看时,可以直接将md文件和图片一起发给对方,否则文件中的图片将无法显示。

2. 网络链接

​ 一般使用网盘之类的网站来存放图片,然后使用网站提供的链接。这样的好处是,发送文件的时候不需要附带图片了,只要有网,就可以看到图片。

​ 我使用的是github存放图片,步骤就是先将图片上传到仓库中,再点击download按钮,在地址栏复制地址即可。

3. base64码

​ 用base64转码工具,将图片转为字符串,再将字符串放入链接的位置。这个时候如果你的markdown编辑器是左右布局的话,会发现一大堆字符串很不美观(我使用的是Typora,不存在这个问题)。

​ 但是还是有解决办法的,上文说了,可以使用变量的方式,将base64码定义在文章末尾,再用id来调用,这样看上去就不会很乱了。

markdown编辑器

我使用的是typora编辑器,原因如下:

  1. 支持数学公式编辑(虽然基本不用)
  2. 丰富的导出格式支持
  3. 简洁(即时渲染而不是左右布局)
  4. 快捷键多,实用
  5. 支持拖拽图片导入(默认关闭的,需要手动打开)
  6. 可以自定义主题
  7. 免费
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 写文的时候弄不清用法,看看下右上设置里的语法参也不是很明白,便自己学习了下,下面是总结,建议收藏。 图片发自简书A...
    林露如雨阅读 4,599评论 6 10
  • 1、定义: Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人...
    零一_fb4d阅读 3,544评论 0 0
  • Markdown 是什么 Markdown 是一种轻量级标记语言,创始人为 John Gruber。它允许人们“使...
    onizuka_jp阅读 3,142评论 0 0
  • 参考文章 8分钟学会Markdown ,写作效率翻一番!新手手册 V2.4 补充:1、所有的语法符号都是英文的,需...
    An_Jun阅读 3,073评论 0 0
  • 谁都有犯拖延症的时候,无论是多锻炼一点,还是多学习点东西,或是晚上早点睡觉。说到为拖延时间找借口,咱们可谓是花样百...
    侯公子一健康笔记阅读 2,507评论 1 1