美文网首页
Markdown入门笔记(针对Typora编辑器)

Markdown入门笔记(针对Typora编辑器)

作者: 运动小爽 | 来源:发表于2018-03-13 08:03 被阅读0次

简介

Markdown是一门轻量级标记语言,它使用简洁的语法代替排版,使我们专心于码字.

它使用简洁的字符标记来达到office/Word中的各种字体/段落等手动设置.由于每个人在使用Word时的文本设置各不相同,就算同一个人,在不同的文档中可能使用的设置方式都不同,就造成了文本的格式和外观千奇百怪.这不利于传播和阅读.

使用Markdown语法来创造内容如记录笔记,写网络博客等各种文档则要方便的多,除了最开始入门时需要记住常规的Markdown标记语法之外,使用Markdown语法写出的文档外观十分优雅简洁,看起来令人赏心悦目.再也不用在Word中每次都手动设置各种字体段落格式了,以后自己记录的所有文档都只有一种格式。这点对于经常在win10和linux系统来回切换的同学十分重要。

Markdown常用语法

标题/Header

在标题前面加上1-6个#,表示一级标题,二级标题...六级标题(#和标题内容之间至少一个空格符隔开):

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

输出效果:


一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表/Lists

Markdown支持有序列表和无序列表.

无序列表使用*或者-或者+作为列表标记:

* Red
* Green
* Blue

- Red
- Green
- Blue

+ Red
+ Green
+ Blue

输出效果:

  • Red
  • Green
  • Blue

有序列表使用数字+英文句点来表示:

markdown
1. Red
2. Green
3. Blue

输出效果:

  1. Red
  2. Green
  3. Blue

强调/Emphasis

两个*或者-表示加粗,一个*或者-表示斜体,~~表示删除:

**加粗文本**或者__加粗文本__
*斜体文本*或者_斜体文本_
~~删除文本~~

输出效果:


加粗文本或者加粗文本

斜体文本或者斜体文本

删除文本


链接/Links

链接语法可掌握常见的2种:标准式自动链接

标准式链接: [百度主页](https://www.baidu.com)
自动链接:直接用`<>`括起来<https://www.google.com>

输出效果:


标准式链接: 百度主页
自动链接:直接用<>括起来https://www.google.com


图片/Images

图片和链接的语法很像,区别在于图片比链接多了一个!.基本格式:

图片: ![]()        ![图片文本(可以忽略不写)](图片地址)

实际插入图片时,常用的有两种情况:插入本地图片插入网页图片

插入网页图片时,()中输入的是图片的网页链接地址:

网页图片: 
![简书](https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=762703104,3048150584&fm=27&gp=0.jpg)

输出效果:

网页图片:  简书

插入一张本地图片时,找到菜单栏的编辑->图片工具->插入本地图片

以上两种方法达到的效果完全一样,此时,图片格式的()中记录的是插入的本地图片的绝对路径.

另外,在文件->偏好设置->编辑器->图片插入处:

Screenshot from 2018-03-09 11-11-22.png

如果勾选优先使用相对路径,在此文档已经保存的前提下,图片格式中的()则记录的是以本文档所在文件夹问根目录的相对路径.

此外,在勾选了允许复制图片到指定文件夹选项的前提下,选择编辑->图片工具->当插入本地图片时->拷贝到文件夹...,此时选择图像拷贝的目标文件夹d-folder

此后,每当使用前面插入本地图片的命令时,程序会自动复制原图片到d-folder文件夹,而且,图片格式中的()里面记录的是d-folder文件夹中图片的绝对路径.

所以,所有的图片都要先保存到本地硬盘,之后才可以进行插入操作.

无论以上哪一种方式,请记住:因为Markdown文件只是一个纯文本文件,图片格式中记录的只是获取图片的路径,当硬盘中的图片被删除或者被移动之后(或者将.md文件复制到别人的电脑上),.md文件中的所有插入的图片都将失效,显示不出来了.

这一点和Word的直接截屏->复制到剪切板->粘贴到Word相比,确实是一个短板,因为Word文件不是纯文本文件,它可以包含图像数据.

所以,为了防止以上图像失效的情况,最好是每次写完一个Markdown文档,就将其导出成PDF或者HTML格式,作为备份.

代码

插入代码的功能可能是Markdown文档最好用的功能之一了.

回想在Word中插入一段代码是什么效果?且不说语法高亮消失,显示效果也是十分丑陋.而在Markdown文档中插入代码的显示效果则几乎接近于专业的代码编辑器了,这一点使得Markdown文档用来写编程类的技术文档相当方便.

代码格式分为2类:

  • 行内代码,或者说成小代码块,适用于在某一行中插入一小句代码.
  • 代码块,当插入一段代码时,使用代码块语法.
行内代码使用` `标识,比如`cv2.namedWindow('image')`
代码块使用``` ```标识,比如:
​

输出效果:
cv2.namedWindow('image')

while(1):
    cv2.imshow('image', img)
    k = cv2.waitKey(1)
    if k==27:
        break
    r = cv2.getTrackbarPos('R', 'image')
    b = cv2.getTrackbarPos('B', 'image')
    g = cv2.getTrackbarPos('G', 'image')
    s = cv2.getTrackbarPos(switch, 'image')
    
    if s==0:
        img[:] = 0
    else:
        img[:] = [b, g, r]
cv2.destroyAllWindows()

分割线

使用三个*生成分割线:

***

输出效果:


参考文章:Typora For Markdown 语法

相关文章

网友评论

      本文标题:Markdown入门笔记(针对Typora编辑器)

      本文链接:https://www.haomeiwen.com/subject/vydnfftx.html