学习书写markdown文档

Posted 2020-10-28 无名码农

markdown 是什么？

同样是标记语言，但它相比html更加简单！一是体现在标记符的数量上，二是体现在标记符的书写上。HTML标记符号非常多，并且需要标记内容的开始和结束位置，而markdown只有四个基本的标记符号，只要在开始位置标记即可。

markdown 解决什么问题？

当我们需要让文档看起来层次分明，但又不依赖于word这样的编辑工具来书写、排版和读取时，markdown的易写易读优势就非常突出了。并且在我使用一段时间以后，发现使用markdown非常有助于帮助作者在写作时整理自己的逻辑思路和段落层次。

怎样书写和读取 markdown？

同HTML一样，你可以使用任何一款纯文本编辑工具来编辑和读取包含markdown格式的文本，但只有在一些特别的工具（如有道云笔记）或网站（如简书）下，才能呈现出渲染后的格式。同时markdown也可以使用HTML来添加格式和排版，这意味着，你即可以使用标准的markdown语法，也可以在其中嵌入HTML标记，但也只能对应其中的一小部分。

markdown 的语法

真的非常简单！
基本符号：* - + >
基本上所有的markdown标记都是基于这四个符号及其组合，需要注意的是，如果以基本符号开头的标记，注意基本符号后分割内容的空格。

• 标题

  • 一级标题 # 一级标题

  • 二级标题 ## 二级标题

  • 三级标题 ### 三级标题

  • 四级标题 #### 四级标题

  • 五级标题 ##### 五级标题

  • 六级标题 ###### 六级标题

• 引用

引用的方式：> 引用内容

• 段落

  • 段落以自然 回车 作为标记。

• 分隔符

  • 连续输入三个以上的---添加横线分隔符，如下：

---

• 列表

  • 使用* - +中的任何一个符号加空格就可以创建无序列表，但如我这样的完美主义者可以进一步使用+ -来表现层次关系。
  • 使用数字+点+空格创建有序列表
  • 列表可以嵌套，使用时在嵌套列表前空格，这篇文章的列表使用了嵌套列表。

* 这是一个无序列表
* 这是一个无序列表

+ 这是一个父无序列表
  - 这是一个子无序列表

1. 这是一个有序列表`
2. 这是一个有序列表`

• 链接

  • 用markdown写下你的第一个md文档 的文章链接是这样构成的

[用markdown写下你的第一个md文档](http://www.jianshu.com/p/de9c98bba332) 

• 也可以直接用尖括号包含网址的方式<http://www.jianshu.com>来构成链接 http://www.jianshu.com

• 图片

  • 像构造一个链接一样，只需要在前面加！

![图片名称](图片地址)

 

简书

• 也可以使用html方式来指定图片大小

<img src="//upload-images.jianshu.io/upload_images/95646-5bfd0cecf587c766.png" width="300px" height="240px" alt="简书">

<img src="//upload-images.jianshu.io/upload_images/95646-5bfd0cecf587c766.png" width="300px" height="240px" alt="简书">

• 代码段

使用
```
代码
```
这样的方式来构建
` 符号在左上角esc键下方，请在半角状态输入

print("这是一个代码段");

• 字体样式

  • 倾斜 *倾斜*
  • 加粗 **加粗**
  • 倾斜并加粗 ***倾斜并加粗***

• 表格

  • 使用- |符号把内容分割为你认为合适的表格样式就好。
  • 使用:符号标识对齐。

表头1|表头2|表头3
:----|:-----:|-----:
左对齐|居中对齐|右对齐

表头1	表头2	表头3
左对齐	居中对齐	右对齐

• 保存

  • 最后将markdown编写的文档存为 .md 格式，就可以用对应的工具查看效果和编辑了。

转载：https://www.jianshu.com/p/de9c98bba332