美文网首页
笔记|Markdown学习笔记及问题总结

笔记|Markdown学习笔记及问题总结

作者: 雪夜闻笛 | 来源:发表于2018-09-02 11:05 被阅读159次

简书江湖中传说中专注于书写的高效写作工具Markdown,到底是什么鬼?

昨天,我花了1个多小时,对markdown写作相关的语法进行了学习,并总结了常见的几个问题。如果你也感兴趣,欢迎围观。

# 一、学习笔记 #

## 1、标题  ##

标题是写作中最常用的格式。

在Markdown中,语法如下:

在文字前面加上 #,并在 # 后加一个空格。

标题总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。

##### 示例代码如下: ####

# h1 一级标题

  ## h2 二级标题

  ### h3 三级标题

  #### h4 四级标题

  ##### h5 五级标题

  ######  h6 六级标题

## 2、列表 ##

写作中,列表常用来梳理文章的条例。

### 2.1无序列表和有序列表 ###

在 Markdown 中,语法如下:

  无序列表:在文字前面加上 - 。

  有序列表:在文字前面加上 1. 2.3.。

注:-、1.和文字之间要保留一个字符的空格。

##### 示例代码如下: ####

  ###无序列表

- 跑步

- 整理读书笔记

###有序列表

1. 跑步

2. 整理读书笔记

### 2.2待办和清单 ###

在Markdown中,语法如下:

在文本或者清单文本前加上- [ ]、- [x]。

- [ ] 表示未完成,- [x] 表示已完成。

注:键入字符与字符之间都要保留一个字符的空格。

##### 示例代码如下: ####

###待办列表

- [ ] 待办项

  - [x] 已完成项

- [x] 已完成项

  - [x] 已完成项

## 3、引用 ##

如果在文章中引用一段别处的句子,那么就要用到「引用」格式。

在Markdown中,语法如下:

在引用文字前加上 > 并与文字保留一个字符的空格,即可。

##### 示例代码如下: ####

> 曾国藩说,知而不行,是未知。

## 4、常用文字格式 ##

### 4.1斜体与粗体 ###

#4.1 基础语法#

在Markdown中,语法如下:

斜体:用一个 * 包含一段文本;

粗体:用两个 ** 包含一段文本;

#4.1 扩展语法#

加粗并斜体:用三个 * 包含一段文本。

注:符号与文本之间无需空格。

##### 示例代码如下: ####

*斜体文字*

**加粗文字**

***加粗斜体文字***

### 4.2其他较常用格式 ###

在Markdown中,语法如下:

下划线:用两个++包含一段文本;

划掉:用两个~包含一段文本;

高亮:用两个=包含一段文本。

##### 示例代码如下: ####

++下划线++ 

~~划掉~~ 

==待高亮的文字(有道云笔记支持,简书和evernote不支持)==

## 5、链接与图片 ##

### 5.1 链接 ###

在Markdown中,语法如下:

链接:[显示文本](图片链接地址)

##### 示例代码如下: ####

[【简明版】有道云笔记Markdown指南](http://note.youdao.com/iyoudao/?p=2411)

[【进阶版】有道云笔记Markdown指南](http://note.youdao.com/iyoudao/?p=2445)

### 5.2 图片 ###

在Markdown中,语法如下:

图片:![](图片链接地址)

##### 示例代码如下: ####

![](C:\Users\Administrator.PC-20160419QVAK\Desktop\简书资料\WangEditor.png)

![](图片链接地址)

注:插入图片的语法和链接的语法很像,只是前面多了一个 !

## 6、分割线  ##

分割线用于分割两段内容。Markdown语法有两种:

a. 另起一行,连续输入三个星号 *** 。(官方推荐)

b. 空一行,然后另起一行连续输入三个 ---。(亲测可用)

##### 示例代码如下: ####

01 引子

02 故事

---

03 小结

## 七、表格 ##

在Markdown文稿中键入表格,语法代码如下:

|表头1 | 表头2|

| --- | --- |

|row 2 col 1 | row 2 col 2|

|row 1 col 1 | row 1 col 2|

注:默认插入的表格为2行3列(含表头1行)。

#### 扩展知识 ####

如需增加行或列,需先增加列。

增加列:文本后增加|。

##### 示例代码如下: ####

3行3列(含表头)

| 文章标题 | 阅读数 | 关注数 |

| --- | --- | --- |

| 文1 | 125 | 36 |

| 文2 | 86 | 12 |

**注意事项(4.16更新)**

- 前后的|必须加上且表头前需空一行,否则不能正常显示。

- MD语法中,最好各语句块都空行,以免出错。(tamlok同学的建议)

如上七大格式是写作文稿时最常使用的。

**更新说明**

感谢tamlok同学协助解决 编辑器中MD不能显示表格的问题。有兴趣的同学,可以参考他这篇[Vim与Markdown,实现键不离手](http://www.jianshu.com/p/fa8c56e1aa52) 。

## 二、相关问题 ##

### 1. 刚开始使用Markdown,经常会忘记相关语法。 ###

- 使用有道云笔记的同学

有道云笔记的工具栏内置了Markdown语法,可以方便学习与熟悉。

如「表格」语法相对复杂,你可能忘记了,怎么办呢?

这时候,你只需要点击编辑框上方工具栏,点选「表格」的图标,左边编辑区便会出现「表格」相应代码。然后,你只需要将代码替换成相应文本即可。

- 使用evernote的同学

建议使用马克飞象,或者作业部落的编辑器。

### 2. 想插入本地图片,如何处理呢? ###

- 感兴趣且有编程基础的同学可直接移步[Markdown中插入图片有什么技巧?](https://www.zhihu.com/question/21065229)的回答。

- 想直奔答案的同学,建议使用富文本方式插入,或者换个更称手的编辑工具。

强烈推荐大辉船长在[一键搞定公众号排版:简书+浏览器插件MarkdownUI Here](http://www.jianshu.com/p/a754957c92e1)中推荐的[WangEditor](http://www.wangeditor.com/)。

##### 推荐理由 #####

我花了1小时时间学会的Markdown语法,却发现这个编辑工具比Markdown更适合不太擅长代码的我。

仅试了一次,就决定只用它了!

#### 3. 如何设置字体、文字颜色和背景呢? ####

Markdown生成的是HTML,而HTML是不表达样式的。字体、颜色、布局这些样式是由CSS来控制的。

如果你确实需要设置这些内容,[石墨文档](https://shimo.im/desktop)

#### 4.Markdown语法和富文本格式可以混合书写吗? ####

用Markdown语法写作过程中 ,我们可以免除点击工具栏进行切换的“干扰”,集中注意力在书写这件事上。可是,插入图片这种操作,对于不熟悉编码操作的同学还是富文本比较快。

要是能混合书写就好了,可是答案是"It cannot do it!(它不能)"。只能说超级可惜(可惜状,大家自行脑补哈)。

#### 5.是否有Markdown相关的源码可学习? ####

因百度云盘分享有问题,暂无法分享链接。如需参考源码,可移步[实践笔记|Markdown学习笔记源码(图片版)](http://www.jianshu.com/p/e9464fc9b7b8)

小提示:源码均在 简书编辑器 中测试通过,请放心使用。

## 三、写在最后 ##

有些工具,玩过了才知道爽。

对于纯文本或仅含少许图片的文章来说,Markdown无疑是专注和高效的利器。

可是对于一个对排版和书写有同等高要求的我来说,我对Markdown的感觉是“累觉不爱”。

我选择的排版工具是——

大辉船长在[一键搞定公众号排版:简书+浏览器插件MarkdownUI Here](http://www.jianshu.com/p/a754957c92e1)中推荐的[WangEditor](http://www.wangeditor.com/)。

如果你有更好的简书能兼容的排版工具,欢迎交流~~

**

我是雪夜闻笛,在写作的路上,愿我们一同精进!

相关文章

网友评论

      本文标题:笔记|Markdown学习笔记及问题总结

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