[ 高效能系列 ] 易读易写的书写语言 Markdown

本文详细介绍Markdown的基本符号及其使用方法,并推荐实用的编辑技巧工具。包括标题、换行、分段等基本格式设置,以及列表、引用、图片链接、表格等进阶功能。此外还提供了脚注的使用方式和表格内容填充工具TablesGenerator的使用方法。

上一篇文章介绍了《如何绘制流程图》,在这篇文章,将介绍两个方面内容:

  1. Markdown 基本符号;
  2. 一些编辑技巧工具。

一、基本符号

1. 标题

语法:# + 空格 + 标题内容

示例:

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

一级标题
======
二级标题
-----

效果:

image

2. 换行

语法:行末加两个空格和一个换行 或在换行处插入<br>

示例:

未换行
的效果

已换行  
的效果

已换行<br>的效果

效果:

image

3. 分段

语法:段落间空一行 或在分段处插入<br></br>

示例:

未分段
的效果

已分段

的效果

已分段<br></br>的效果

效果:

image

4. 加粗、斜体、删除线、底纹

语法:**加粗** *斜体* 删除线 (⚠️ 注意:符号和文字间没有空格)

示例:

**加粗**

*斜体*

~~删除线~~

` 底纹 `

效果:

image

5. 列表

语法:无序列表直接在文字前加 「 - 」 或者 「 * 」或者 「 + 」 即可,有序列表则直接在文字前加 「1.」「2.」「3.」 。在 「 * 」「 - 」「 + 」「1.」「2.」「3.」等前加两个空格键或者一个 tab 键就可以产生一个子列表。

⚠️ 注意

    1. 符号要和文字之间加上一个字符的空格;

    3. 同一级的有序列表中的序号是连续的数字,它们与编号符号无关。

示例:

#### 有序列表

1. text 1
2. text 2
  3. subtext 1
  4. subtext 2
5. text 3
6. text 4 

#### 无序列表

- text 1
- text 2
  - subtext 1
  - subtext 2
- text 3
- text 4 

效果:

image

6. 引用

语法:在文本内容之前加 「 > 」 即可将文本变成引用文本。「 >> 」 表示引用里面再套一层引用,依次类推。

⚠️ 注意

    1. 如果 > 和 >> 嵌套使用的话,从 >> 退到 > 时,必须之间要加一个空格或者 > 作为过渡,否则默认为下一行和上一行是同一级别的引用。

    2. 引用标记里可以使用其他标记,如:有序列表或无序列表标记,代码标记等。

示例:

> 书山有路勤为径,学海无崖苦作舟
> 书山有路勤为径,学海无崖苦作舟
>> 书山有路勤为径,学海无崖苦作舟

>> 书山有路勤为径,学海无崖苦作舟
>>> 书山有路勤为径,学海无崖苦作舟
>>>> 书山有路勤为径,学海无崖苦作舟
>>>>> 书山有路勤为径,学海无崖苦作舟
>>>>>> 书山有路勤为径,学海无崖苦作舟
>>>>>>> 书山有路勤为径,学海无崖苦作舟

效果:

image

7. 图片和链接

语法:![图片描述](图片的地址或存储路径) [文本内容](链接的地址)

示例:

#### 博客链接
[my blog](https://sinsa110.github.io/)

#### 绘制流程图基本技巧中的图片
![决策流程图](https://user-images.githubusercontent.com/13688310/40121933-3aed351e-5955-11e8-99b9-96f742e6acf6.png)

效果:

image

8. 表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右

⚠️ 注:原生的语法两边都要用 | 包起来。此处省略

示例 & 效果:

image

9. 脚注

语法:脚注总是成对出现的,「 [^1] 」作为标记,可以点击跳至末尾注解。「 [^1]: 」填写注解,不论写在什么位置,都会出现在文章的末尾。

示例:

### 脚注

标记[^1]
[^1]: 注解

效果:

image

二、技巧 & 工具

1. 表格内容填充工具 Tables Generator

Tables Generator 是一个可以在线快速生成 Text、Markdown 格式等多种格式表格的工具,支持在表格中填充数据,保证排版整齐,而且支持将Excel等的表格转化为markdown的格式,生成复制以后即可使用。

示例:

markdown_table_new

参考资料

  1. http://www.markdown.cn
  2. https://blog.csdn.net/witnessai1/article/details/52551362
  3. https://segmentfault.com/markdown
前言 论坛上新【markdown】格式解析功能 什么是MarkDownMarkdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeX,Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHub和Wikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动。 - 摘自百科 MarkDown用途: Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如Joomla、Drupal都能很好的支持Markdown。完全采用Markdown编辑器的博客平台有Ghost和Typecho。用于编写说明文档,并且以“README.md”的文件名保存在软件的目录下面。除此之外,由于我们有了RStudio这样的神级编辑器,我们还可以快速将Markdown转化为演讲PPT、Word产品文档、LaTex论文甚至是用非常少量的代码完成最小可用原型。在数据科学领域,Markdown已经广泛使用,极大地推进了动态可重复性研究的历史进程。 - 摘自百科 详细可参考:【帮助文档】Markdown插件使用说明 正文 论坛的增加MarkDown编辑器固然很好,但是增加了没有人去使用也没有意义啊,于是我动手写了一个MarkDown编辑器,基于开源作品Editor.md。 废话不多讲,单击这里可以直接查看:http://pandao.github.io/editor.md/ - MarkDown-Notepad有什么优点呢? 1、使用方便: 集成Editor的优点,支持保存文件,读入文件(但由于时间仓促,这部分不是很完善) 2、编辑快速: MarkDown易于编辑,易于上手,易于处理 3、支持自定义个性化 4、支持导出: 好了好了,干瘪瘪地讲了半天也没有什么意思,直接上图片: 1.支持链接(废话) 2.支持HTML(废话) 3.支持多语言代码高亮(好吧这是CSS功劳) 4.支持图片(废话) 5.流程图: 关于Editor.md: 主要特性 支持“标准”Markdown / CommonMark和Github风格的语法,也可变身为代码编辑器; 支持实时预览、图片(跨域)上传、预格式文本/代码/表格插入、代码折叠、搜索替换、只读模式、自定义样式主题和多语言语法高亮等功能; 支持ToC(Table of Contents)、Emoji表情、Task lists、@链接等Markdown扩展语法; 支持TeX科学公式(基于KaTeX)、流程图 Flowchart 和 时序图 Sequence Diagram; 支持识别和解析HTML标签,并且支持自定义过滤标签解析,具有可靠的安全性和几乎无限的扩展性; 支持 AMD / CMD 模块化加载(支持 Require.js Sea.js),并且支持自定义扩展插件; 兼容主流的浏览器(IE8+)和Zepto.js,且支持iPad等平板设备; 支持自定义主题样式;Editor.md 的诞生依赖于以下开源项目:>CodeMirrormarkedjQueryFontAwesomegithub-markdown.cssKaTeXRephael.jsprettify.jsflowchart.jssequence-diagram.jsPrefixes.scss 功能实现 主要是JS填表: 结尾语 对于MarkDown,还有很多功能尚未发掘,更多功能可以百度或者自行开发 PS:Editor.md遵循和使用 MIT License 开源协议 本程序使用以下模块: 模块名 作用 作者或工作室 Win10皮肤模块 加载皮肤 清风科技 miniblink 用作加载editor(实际的作用是加载浏览器) kyozy,来自 “龙泉寺扫地僧” 的DLL,本模块来自论坛 结尾小彩蛋: 我在玩Editor.md的时候的一个小发现:“.\editor.md-master\examples\change-mode.html”
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Sinsa_SI

您的鼓励是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值