了解Markdown语法

原创于 2019-04-03 14:55:00 发布 · 108 阅读

0 ·

CC 4.0 BY-SA版权

本文对比分析了富文本编辑器、Markdown及HTML三种文本编辑方式的优劣，并结合程序员的实际需求，推荐了一种高效的文档撰写格式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

作为初入简书的小白，第一个遇到的问题就是选择文本输出格式。
目前我可选择的有三种形式：富文本编辑器（类WORD），被种草的MARKDOWN，以及写了三年的HTML。

下面从实用性来分析一下：
（1）富文本编辑器：作为一枚程序员，要入坑的不仅仅是简书，还有GITHUB，优快云，博客园，这三个是最基本的程序员文档分享网站。随着市场的发展，各个大小的文档归档分享网站应运而生，每个网站对富文本编辑器的兼容性都不一样，例如使用富文本编辑器在简书上编辑好的文章在优快云上显示的效果会出现格式混乱，所以这一方案被果断拒绝了。

（2）MARKDOWN：可以理解为HTML的缩写版，用简单的符号形式生成HTML。所以本质上来说，MARKDOWN可以直接编辑HTML，也可以偷懒使用缩写版富豪代替多余的标签，所以这就容易明白了，MARKDOWN书写性和学习程度都低于HTML。最关键的是，兼容市场上各种文档分享网站。看上去不错哟~值得考虑下。

（3）HTML：对于入行前端三年多的程序员来说，HTML就跟亲人一样，亲切。对于任何标签样式都可以信手捏来，但是，MARKDOWN无论是书写性还是效率都比HTML高一截，故而得出结论，以后文档采用MARKDOWN + HTML书写。

结论：

操作难度等级：
富文本编辑器 < MARKDOWN < HTML

通用优先等级：
富文本编辑器 < MARKDOWN < HTML

划重点：

HTML块标签不处理MARKDOWN语法，但是行内标签有效。
（块标签和行内标签自行了解）
特殊字符
版权符号©：©
反斜杠\插入普通的符号：
\ 反斜线 ` 反引号 * 星号 _ 底线 {} 花括号 [] 方括号 () 括弧 # 井字号 + 加号 - 减号 . 英文句点 ! 惊叹号
换行和空格
- 段落之间空白行直接回车回车。
- 首行缩进：一个空格 &+ensp; 两个空格 &+emsp;
标题
# 这是 H1
## 这是 H2
###### 这是 H6
区块引用
每行的最前面加上>，可以嵌套>>
列表
(1) 无序列表，* + - 都可以，至少三个空格
* Red
* Green
* Blue
（2）有序列表则使用 数字+英文句点，数字并不会影响输出的 HTML 结果，至少两个空格
1. Bird
2. McHale
3. Parish
分隔线：***， ---
链接
格式： [文字] （网址 "Title"）
This is [an example](http://example.com/ "Title")
This is [an example](http://example.com/ )
<http://example.com/>

链接中如有空格，用%20替换

强调
*斜体* _斜体_
**加粗** __加粗__
~~删除线~~
代码
行内代码，你可以用反引号包起来
`一个反引号` ``两个反引号`` ` ```代码````
图片

![图片描述](图片链接地址)

表格（前后有空格）

极简模式

name | 价格 |  数量  
-|-|-
香蕉 | $1 | 5 |
苹果 | $1 | 6 |
草莓 | $1 | 7 |

name	价格	数量
香蕉	$1	5
苹果	$1	6
草莓	$1	7

简单方法

name | 111 | 222 | 333 | 444
- | :-: | :-: | :-: | -:
aaa | bbb | ccc | ddd | eee| 
fff | ggg| hhh | iii | 000|

name	111	222	333	444
aaa	bbb	ccc	ddd	eee
fff	ggg	hhh	iii	000

原生方法（都居中）

name | 111 | 222 | 333 | 444
:-: | :-: | :-: | :-: | :-:
aaa | bbb | ccc | ddd | eee| 
fff | ggg| hhh | iii | 000|

name	111	222	333	444
aaa	bbb	ccc	ddd	eee
fff	ggg	hhh	iii	000