惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
W
WeLiveSecurity
O
OpenAI News
N
News and Events Feed by Topic
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
Webroot Blog
Webroot Blog
Google Online Security Blog
Google Online Security Blog
云风的 BLOG
云风的 BLOG
N
News | PayPal Newsroom
H
Hacker News: Front Page
博客园_首页
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
The Last Watchdog
The Last Watchdog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
H
Heimdal Security Blog
cs.AI updates on arXiv.org
cs.AI updates on arXiv.org
S
Schneier on Security
宝玉的分享
宝玉的分享
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Recent Commits to openclaw:main
Recent Commits to openclaw:main
Y
Y Combinator Blog
Cyberwarzone
Cyberwarzone
Microsoft Security Blog
Microsoft Security Blog
C
CXSECURITY Database RSS Feed - CXSecurity.com
GbyAI
GbyAI
Cloudbric
Cloudbric
TaoSecurity Blog
TaoSecurity Blog
人人都是产品经理
人人都是产品经理
P
Palo Alto Networks Blog
M
MIT News - Artificial intelligence
G
GRAHAM CLULEY
C
Check Point Blog
Apple Machine Learning Research
Apple Machine Learning Research
Last Week in AI
Last Week in AI
T
Troy Hunt's Blog
L
Lohrmann on Cybersecurity
www.infosecurity-magazine.com
www.infosecurity-magazine.com
P
Proofpoint News Feed
Blog — PlanetScale
Blog — PlanetScale
量子位
博客园 - 聂微东
S
Securelist
博客园 - 三生石上(FineUI控件)
F
Full Disclosure
G
Google Developers Blog
L
LINUX DO - 热门话题
P
Proofpoint News Feed
AI
AI
PCI Perspectives
PCI Perspectives

庭说

使用 SSH(Secure Shell)客户端(PuTTY)远程连接 VPS 如何注册 Google(谷歌)账号 如何在小米 6 上安装 Google Camera(谷歌相机) 宠物成长日志 Telegram 动态大表情合集 已弃的番茄 拨开迷雾看世界 装上油猴脚本,你的浏览器才有了灵魂 沙拉查词:浏览器上最强大的划词翻译插件 COVID-19 防疫手记 GTD 时间管理法则 Google Ads 教程 WhatsApp:解封 & 最小化 如何在 LinkedIn(领英)开发客户 Cold Email(开发信)撰写指南 Telegram(电报):新手指南、使用教程及频道推荐 英语口语:发音篇 如何提升外贸业务技能? 如何组织一场全员参与的培训活动 英语语法 Google Chrome(谷歌浏览器):扩展程序(插件)推荐及使用技巧 除了健康,都是小事 SwitchyOmega:在浏览器上轻松管理代理规则 阿里巴巴国际站:新手不完全入门指南 如何学英语 英语口语:外贸篇 英语杂货店 游泳入门与蛙泳教学 大客户下单后,如何用邮件有效跟进? Illustrator, Photoshop and InDesign Tips 宝宝起名 求职:简历与面试 英语口语:黑人篇 Inkscape:位图矢量化的最佳工具 如何做出合格的 PPT 平面设计学习手记 摄影技巧 PDF:批量裁剪与拆分 独居青年的烹饪笔记 e 邮宝支持投递的国家 如何寻找共享美区苹果账号(Apple ID) 美区苹果账号(Apple ID)注册指南 《作文七巧》 Google Cloud Platform 注册和使用指南 eBay Listing(刊登)指南 互联网百宝箱 想要更高效地找到信息,你需要掌握这些搜索技巧 驾考指南 「喝茶」历险记 Windows 10 电脑:使用技巧、佳软推荐以及系统重装教程 人身保险入门指南 文案风格指南:中英混排和标点符号的用法 好好牙刷,很有必要 番茄种植指南(梯子搭建教程) 如何优化 Hexo(静态博客) 为什么要写博客? 「庭说」的品牌设计 日志 毕业赠言 微信公众号排版心得 庭说的微信公众号被封了 番茄食用指南(科学上网教程) 《瑞克和莫蒂》中英字幕文本 Who Am I
Markdown 入门教程及书写风格指南
庭勃士(Dr_Ting) · 2016-03-15 · via 庭说

markdown现代汉语就像用脏了的人民币,要用 Markdown 洗一洗。Markdown 是一种轻量级标记语言。你不需要关心标题多大字号,段前距多少,列表缩进几格,只要在纯文本前后增加一些标记符号(例如 # - * >),就能毫不费力地写出工整精美的文章。毫不夸张地说,Markdown 是比特世界赠与写作者的「笔」。

请注意,Markdown 不要写成 MarkDown。

优势

掐指一算,使用 Markdown 写文章三年有余了。它的好,目前谁都比不了。

易学易记

只要几分钟就可以 学会 Markdown,然后你可能再也不想碰 Word 了。

专注写作

富文本编辑器(例如 Word)是通过点击图形化的功能按钮来实现排版,而 Markdown 则是通过标记字符去赋予文字不同格式。易读易写(easy-to-read and easy-to-write),让任何与文字打交道的人专注于写作,不用操心排版。

格式统一

同一份 Word 文档,在

  • 不同的设备:Windows、macOS、Android、iOS
  • 不同的版本:旧版 Word 、新版 Word
  • 不同的软件:Microsoft Office、WPS

可能显示不一样的效果。而 Markdown 可以 Write once, export everywhere。不管在电脑上,还是手机上,用 Markdown 写出来的文章都能带来舒适、统一、美好的阅读体验。

向外兼容

可以导出 PDF、 Word、HTML、图片等格式分享给没有安装 Markdown 编辑器的人。

入门

一开始你只要记住以下符号(英文半角状态),就能写出排版清爽的文章了。

标记符号 标记结果
# + 空格 + 文本 一级标题
## + 空格 + 文本 二级标题
### + 空格 + 文本 三级标题
- + 空格 + 文本 无序列表
1 + . + 空格 + 文本 有序列表
> + 空格 + 文本 引用

如果有些文字需要特殊说明:

标记符号 标记结果
** + 加粗 + ** 加粗
* + 斜体 + * 斜体
~~ + 删除线 + ~~ 删除线

是不是手痒了?下载一个 Markdown 编辑器, Keep calm and Markdown。目前我使用 有道云笔记 + Typora

  • Windows 用户推荐 Typora
  • Android 用户推荐 纯纯写作。
  • 苹果用户(iOS 和 macOS)可以在 App Store 搜索「Markdown」下载(没用过苹果产品,没有发言权)。

What You See Is What You Mean

进阶

以上就是最基础的 Markdown 语法,普通用户看到这里就可以开始动笔尝试了。下面介绍一些 Markdown 的书写风格,让你的源码和文档更精美,更有条理。你不必一下子全部记住,需要实现哪个功能再来查阅或者问 Google 也不迟。

标题

层级

  • 正文的标题从 ## 开始,# 要留给整篇文章的标题(也可以不写)。这样的大纲结构也可以很方便地转换为思维导图(Markdown to Xmind / MindNode / 幕布 / 百度脑图……),也符合 SEO(搜索引擎优化)的规则。

    # 一级标题(h1):文章的标题
    
    ## 二级标题(h2):正文的大标题
    
    ### 三级标题(h3):正文的小标题
  • 虽然 Markdown 最大支持 ###### 六级标题,为了保持层级的简单,防止出现过于复杂的章节,请谨慎使用四级标题(除非是长文章)。如果三级标题下有并列性的内容,可以使用加粗、有序列表或无序列表代表末级标题。

    
    短文章的标题层级
    
    ### 正文的小标题
    
    **三级标题 A**
    - 论据 1(五级标题) 
      - 细分论据 1(六级标题) 
      - 细分论据 2(六级标题) 
      - 细分论据 3(六级标题) 
    - 论据 2 
    - 论据 3
    
    
    **三级标题 B**
    1. 论据
    2. 论据
    3. 论据
    
    
    **三级标题 C**
    - 论据 1 
    - 论据 2 
    - 论据 3
    
    
    ---
    
    长文章的标题层级
    
    ### 正文的小标题 
    
    #### 正文的三级标题 A
    
    #### 正文的三级标题 B
    
    #### 正文的三级标题 C
    
  • 二级标题下,不能直接出现四级标题。

  • 标题要避免孤立编号(即同级标题只有一个)。

  • 标题要简短,结尾不带标点符号。

  • (源码上)标题前后空一行(段前距和段后距)。

  • 大标题和小标题之间要有内容过渡(引出或概括下文)。

    # Title
    
    开门见山地告诉读者这篇文章讲什么?
    
    一级标题作为文章的(页面)标题(H1),并且尽可能和文件名称保持一致。
    
    如果文章很长,使用 [TOC] 生成目录。
    
    ## What
    
    先定义问题是什么?……
    
    正文从二级标题开始。
    
    ## Why
    
    为什么会出现这样的问题?……
    
    ## How
    
    下一步该怎么办?……
    
    ## See also
    
    文末别忘了贴上参考链接。
    
    * https://link-to-more-info

列表

无序列表

使用 *+ 并跟随 1 个空格来表示无序列表。建议使用 (连字符,hyphen)。

- 我是谁
- 我从哪里来
- 我到哪里去

不建议

* 我是谁
* 我从哪里来
* 我到哪里去

---

+ 我是谁
+ 我从哪里来
+ 我到哪里去

为什么

  • 星号 * 可能和加粗和斜体符号产生混淆。
  • 加号 + 不流行。

与其他语法结合使用

- **《春日》**:等闲识得东风面,万紫千红总是春。
- **《春草》**:萋萋总是无情物,吹绿东风又一年。
- **《墨梅》**:犹恨东风无意思,更吹烟雨暗黄昏。

预览

  • 《春日》:等闲识得东风面,万紫千红总是春。
  • 《春草》:萋萋总是无情物,吹绿东风又一年。
  • 《墨梅》:犹恨东风无意思,更吹烟雨暗黄昏。

有序列表

语法一(手动排序)
1. 斜月沉沉藏海雾,碣石潇湘无限路。
2. 不知乘月几人归,落月摇情满江树。
3. 春江潮水连海平,海上明月共潮生。

预览

  1. 斜月沉沉藏海雾,碣石潇湘无限路。
  2. 不知乘月几人归,落月摇情满江树。
  3. 春江潮水连海平,海上明月共潮生。

对于比较短的、很少修改的有序列表,请按顺序标号,保持源码的可读性。

语法二(自动排序)

对于比较长的、可能会修改的列表(尤其是很长的嵌套列表),请使用「懒人编号法」。纵使有新的列表项「插队」,把序号弄乱了也没关系,Markdown 编辑器自动会对序号进行纠错。

1.  Foo.
1.  Bar.
    1. Foofoo.
    1. Barbar.
    1. Gargar
1.  Baz.

预览

  1. Foo.
  2. Bar.
    1. Foofoo.
    2. Barbar.
    3. Gargar
  3. Baz.

嵌套列表

缩进 2 ~ 4 个空格或一个 Tab(推荐),可以嵌套列表。

示例一

1.  不知乘月几人归,落月摇情满江树。
	- 与君吟弄风月,端不负平生。
	- 对秋深,离恨苦,数夜满庭风雨。
	- 五月畲田收火米,三更津吏报潮鸡。
2.  人姝丽,粉香吹下,夜寒风细。
	- 弓弦抱汉月,马足践胡尘。
	- 寒月悲笳,万里西风瀚海沙。
	- 东堂坐见山,云风相吹嘘。
3.  沅溪夏晚足凉风,春酒相携就竹丛。
	- 白发渔樵江渚上,惯看秋月春风。
	- 归来独卧逍遥夜,梦里相逢酩酊天。
	- 致君尧舜上,再使风俗淳。

预览

  1. 不知乘月几人归,落月摇情满江树。
    • 与君吟弄风月,端不负平生。
    • 对秋深,离恨苦,数夜满庭风雨。
    • 五月畲田收火米,三更津吏报潮鸡。
  2. 人姝丽,粉香吹下,夜寒风细。
    • 弓弦抱汉月,马足践胡尘。
    • 寒月悲笳,万里西风瀚海沙。
    • 东堂坐见山,云风相吹嘘。
  3. 沅溪夏晚足凉风,春酒相携就竹丛。
    • 白发渔樵江渚上,惯看秋月春风。
    • 归来独卧逍遥夜,梦里相逢酩酊天。
    • 致君尧舜上,再使风俗淳。

示例二

- 庭说栏目
	> - 排版美学
	> - 数字生活    
	> - 日志随笔
- 联系方式
	> - Email:tingtalk.me(at)gmail.com
	> - Telegram:t.me/tingtalkgroup  
	> - WeChat:804 976 336

预览

Tips

  • Tab 缩进一级
  • Shift + Tab 提升一级

任务列表

语法

- [ ] 纯牛奶
- [x] 西瓜
- [ ] 鸡蛋
- [x] 保鲜膜
- [ ] 猪肉(暂时买不起)

预览

  • [ ] 纯牛奶
  • [x] 西瓜
  • [ ] 鸡蛋
  • [x] 保鲜膜
  • [ ] 猪肉(暂时买不起)

引用

在每一行使用 > 符号,包括换行的句子。

> 我们是为人民服务的,所以,我们如果有缺点,就不怕别人批评指出。
> by 毛泽东:《为人民服务》(1944 年 9 月 8 日)

我们是为人民服务的,所以,我们如果有缺点,就不怕别人批评指出。
by 毛泽东:《为人民服务》(1944 年 9 月 8 日)

表格

语法

| 左对齐           |                      居中对齐                      | 右对齐 |
| :--------------- | :------------------------------------------------: | -----: |
| **加粗**         |          [插入链接](https://tingtalk.me/)          |  ¥5.7 |
| `换行`<br />下一行 | ![插入图片](https://tingtalk.me/uploads/avatar.png) | ¥10.4 |

预览

左对齐 居中对齐 右对齐
加粗 插入链接 ¥5.7
换行
下一行
插入图片 ¥10.4

注释

  • Markdown 是轻量级的标记语言,所以不支持合并和拆分单元格。对于复杂表格,你可以在 Markdown 编辑器中使用 HTML 的 <table> 标签标记。
  • 输入 <br /> 可以换行(但不建议使用)。
  • 把 Excel 表格复制粘贴到某些 Markdown 编辑器(例如 Typora)可以直接转换为 Markdown 形式的表格。

链接

语法

[庭说](https://tingtalk.me/)

预览庭说

图片

语法

![庭说 Avatar](https://tingtalk.me/images/avatar.png)

预览

庭说 Avatar

Markdown 是一种纯文本标记语言,图片功能注定是它的弱项。

网络图床

但谁能保证哪个图床服务不倒闭?所以我在写作的时候,力求用文字把事情解释清楚,能不插入图片就不插入图片。我偶尔会用到的 图床sm.ms(免费)。

本地图片

Typora 支持插入本地图片,但是更改图片的路径和名称,图片就失效了。如果文章已经完稿了,可以把 Markdown 导出为 PDF 文档(这样图片就嵌入进去了)。

代码

行内代码

用 2 个重音符 `(backtick,在 Tab 键上方)包裹

`Markdown` 是一种轻量级标记语言。

预览

Markdown 是一种轻量级标记语言。

用两个 ` 包裹 `,才能显示 `

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

预览
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`

重音符前后空一格

- 推荐:使用键盘快捷键 `Ctrl + D` 可以将当前网页保存为书签。
- 反对:使用键盘快捷键`Ctrl+D`可以将当前网页保存为书签。

预览

  • 推荐:使用键盘快捷键 Ctrl + D 可以将当前网页保存为书签。
  • 反对:使用键盘快捷键Ctrl+D可以将当前网页保存为书签。

代码块

将 3 个重音符 ` 置于代码块的首行和末行。首行的重音符后面可接代码语言名称,例如 `````python``,以达到相应的代码高亮效果。

print "Hello, Python!"

预览

print "Hello, Python!"

diff 代码对比

function addTwoNumbers (num1, num2) {
-  return 1 + 2
+  return num1 + num2
}

预览

function addTwoNumbers (num1, num2) {
-  return 1 + 2
+  return num1 + num2
}

换行

以下键盘快捷键(语法)可能仅支持 Typora。

Enter = 换行 + 空行 = (Shift + Enter) × 2。

即按下回车键创建一个新段落(段与段之间加入空行)。

软换行

Shift + Enter = 换行(但是不会产生空行)。

`enticing` [ɪn'taɪsɪŋ] (事物)诱人的,有吸引力的;迷人的
- Her neck was short but rounded and her arms plump and enticing. `Shift` + `Enter`
  她的脖子短,但浑圆可爱;两臂丰腴,也很动人。by 《飘》 `Enter`

- This was enticing to Wozniak, even more than any prospect of getting rich. `Shift` + `Enter`
  这句话对沃兹尼亚克的诱惑太大了,比变成富人的诱惑还要大。by 《乔布斯传》 `Enter`

enticing [ɪn'taɪsɪŋ] (事物)诱人的,有吸引力的;迷人的

  • Her neck was short but rounded and her arms plump and enticing.
    她的脖子短,但浑圆可爱;两臂丰腴,也很动人。by 《飘》

  • This was enticing to Wozniak, even more than any prospect of getting rich.
    这句话对沃兹尼亚克的诱惑太大了,比变成富人的诱惑还要大。by 《乔布斯传》

硬换行

在行末使用空格(两个以上) + 换行(Enter),就可以实现强制换行,此语法适用于大部分 Markdown 编辑器。

硬换行在文档被导出时将被保留,且没有换段的段后距。

假如生活欺骗了你,  (2 个空格)
不要悲伤,不要心急!  (2 个空格)
忧郁的日子里须要镇静:  (2 个空格)(2 个空格)
相信吧,快乐的日子将会来临!  (2 个空格)
心儿永远向往着未来;  (2 个空格)
现在却常是忧郁。  (2 个空格)
一切都是瞬息,一切都将会过去;  (2 个空格)
而那过去了的,就会成为亲切的怀恋。   (2 个空格)
by 普希金

假如生活欺骗了你,
不要悲伤,不要心急!
忧郁的日子里须要镇静:
相信吧,快乐的日子将会来临!
心儿永远向往着未来;
现在却常是忧郁。
一切都是瞬息,一切都将会过去;
而那过去了的,就会成为亲切的怀恋。
by 普希金

其他

名称 语法 备注
分割线 ---***+++ 不常用
内容目录 [TOC] Table of Contents

应用

Markdown 的用途很广。Write once, export everywhere:写博客、写邮件、排推文、做 PPT 等。

公众号排版

简历排版

邮件排版

Markdown Here 是一个浏览器扩展插件,可以将浏览器中编辑器(例如 email 正文)里的 Markdown 文本转换成渲染过后的 HTML,并且支持自定义 CSS。

修改 CSS 样式教程:

转换为 Word

  • 安装 Pandoc 后,Typora 可以导出 Word

转换为 Mind Map

  • 对于 Xmind / MindNode / 百度脑图 等思维导图工具,直接导入 md 文档。
  • 对于幕布,可以用 Typora 导出 opml 格式,再导入。
  • MarkmapMarkdown + Mindmap,使用思维导图可视化 Markdown。

从网页导出 md 格式

借助浏览器插件 简约 导出 md 格式的网页,不用 手动添加标记符号。

导出漂亮的 Markdown 源代码图片

  1. 打开 carbon.now.sh
  2. 语言选择 Markdown
  3. 书写或者粘贴 Markdown 源代码
  4. 导出 PNG 像素图或者 SVG 矢量图

参考资料

关联阅读