跳至主要内容

Markdown标记语法，从入门到熟练

Markdown标记语法，从入门到熟练

Markdown标记语法，从入门到熟练Markdown生为专注和一致性体验机器编译和自然语言之间的理解鸿沟Markdown的学习成本总结一下，Markdown的优点Markdown语法能在哪使用？有专门编写markdown的软件吗？Markdown不能做什么Reference

Markdown生为专注和一致性体验

We believe that writing is about content, about what you want to say - not about fancy formattin.
我们坚信写作写的是内容，所思所想，而不是那些花哨格式。——Ulysses for Mac
Markdown标记语法，由约翰·格鲁伯（John Gruber)于2004年创立，2017年，GitHub 发布了基于CommonMark 的 Github Flavored Markdown（GFM）的正式规范。
约翰·格鲁伯对于Markdown的定义是：Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML). (Markdown是面向Web作家的文本到HTML转换工具。Markdown允许您使用易于阅读，易于编写的纯文本格式进行编写，然后将其转换为结构上有效的XHTML（或HTML）。)
对于经常需要专注写东西的人来说，markdown标记语法是一个必备的工具。它能够让你双手不离开键盘的情况下（只是使用键盘，而不用鼠标或触屏），实现给文本加粗，区别各级标题，引用格式，插入图片、链接、表格、甘特图、数学公式等等功能。markdown盛行于程序员圈子，是编码的好伙伴。其实markdown本身也是一种编码形式，markdown语法在机器和人之间搭建了一个桥梁，让人用机器读得懂的语言和机器进行对话，而不是相反，因此也省略了大量中间环节，变得轻量化。
轻量化和标准化带来的好处不只是书写过程行云流水般的敲字体验和黑客范式，还在于由于它的编码化形式，因此它的格式是一致的。什么意思呢？我们都有这种体验，一份Word文档，在自己电脑上看还好好的，但是发给同事就乱码了，这多半是由于两个软件平台编码格式不一致导致的，而markdown不存在这样的问题，使用正式规范的编码对文本进行的格式化，在任何支持markdown的平台，都能正常显示（由于平台显示形态可能不一样，比如标题的颜色、引用线粗细等会不太一样，因此要忠实重现文本，最好用PDF版本进行文件的传阅）。
和markdown相对的，便是富文本格式，像微软的Word，搭载的就是富文本格式。你可以把markdown理解成一个指路的路标，行人就像机器，看到这个路标，就知道应该往哪儿走，能够识别markdown语法的载体，当我们用markdown进行写作时，它会自动识别并执行相对应“使文本格式化”的操作。

机器编译和自然语言之间的理解鸿沟

对于富文本格式来说，由于软件担当了第三者，因而机器本身的表达形式和使用者对其的理解，都不可避免的存在差异。似乎看起来，富文本格式可见即可得的形式使得人们使用Word手到擒来。可是，君不见多少人在无数个深夜面对怎么弄成这样的文档格式而掉发无数。而markdown不一样，它使用机器的语言和机器进行交流，就像来到中国用中文一样，不再因为蹩脚的外语而造成理解的混乱，也无需再费力去学习外语。
Markdown就像一个可回溯的路标，走错了路可以跟着路标再走回来。而像Word这样的富文本，越往前走，身后的路标离你越远，直至最后消失不见。这对于一个越是往前走，越需要向后回顾的人，无疑是一种不留后路的背叛。
说到这里，我们知道了markdown标记语言和富文本之间的本质不同。那么，现在问题来了，markdown既然是机器语言，那么非程序员的学习成本高吗？

Markdown的学习成本

Markdown虽然是多为程序员使用，但是学习成本并不高，相反使用成本（习惯成本）很高。这个问题理解起来有两个维度，长期和短期。
就短期来看，markdown的使用成本非常高，也许你在富文本格式软件中的效率会是markdown的好几倍。同时，由于markdown遵循严格的语法规范，所以对于字符的缺漏、错位以及需要英文状态下输入，这些问题和富文本形式下的用顺了手、可见即可得产生感受上强烈的差别，使得markdown被完全打趴在地。因此，强烈不建议短期使用markdown标记语言。
长期来看，markdown无疑是一劳永逸的绝佳注解。因为就目前来说，对于纯文本格式的编辑，标记语言无非就三种类型，五分钟就能学会，后续只是需要混个手熟罢了。而对于长期主义者来说，五分钟学好的事，花五个月用熟练，然后一辈子受用，是个再自然不过的事情。以下为最为常用语法：
Basic writing and formatting syntax
EMOJI CHEAT SHEET
Markdown Reference from Typora
​
第一类，文字标记（空格表示文字）：* *标示斜体，** **标示粗体,~~ ~~标示删除线,<fanhousuibi@outlook.com>标示超链接（点击即打开邮箱）；
​
第二类，段落标记（空格表示文字）：# 标示一级标题、## 标示二级标题、如此增加到六级标题，> 标示段落引用，- 标示无序列表，1. 2. 3. ...标示有序列表，***/---/+++ 标示分割线,~~~ 标示区块，` `标示代码块;
​
第三类，插入文本的其他标记：[输入网站名称](输入网址)标示超链接，![图片名称](图片位置：图片网址\本地图片相对位置)插入图片(![Alt text](/path/to/img.jpg)/![Alt text](/path/to/img.jpg "Optional title"),
| | |
|---|---|---|插入表格，-[ ]&-[x]任务清单,:emojiname:插入表情 :zzz: insert sleep emoji，
| | |
​
输入[toc]生成文章目录
​
网址自动变成一个超链接。
​
footnote[^here is the text of the footnote]
[^footnoe]:here is the text of the footnote.
​
[an example][id]参考链接（第二个中括号内容可以省略，第一个中括号这时会被当做id使用）
​
` `标示代码块
​
<u> </u>标示下划线
​
下标
用一个~，如果要写水分子，则是H~2~O（在typora上要在文件》偏好设置》markdown》markdown扩展语法里进行设置
​
上标
用^前后分隔，比如X的平方可以表示为X^2^
​
Hold down Cmd(on Windows:Ctrl) and click on [this link](#block-element) to jump to header `Block Elements`.
​
<video src=" ">插入视频
​
<audio src="xxx.mp3" />插入音频
输入[toc]生成文章目录(TOC:Table of Contents)
Hold down Ctrl and click on this link to jump to header to 机器编译和自然语言之间的理解鸿沟
You can create footnotes like thisfootnote
[footnote]  here is the text of the footnote.

总结一下，Markdown的优点来源

  • 专注你的文字内容而不是排版样式
  • 轻松的导出HTML、PDF和本身的.md文件
  • 纯文本内容，兼容所有的文本编辑器与文字处理软件
  • 随时修改你的文章版本，不必像文字处理软件生成若干文件版本导致混乱
  • 可读、直观、学习成本低
[来源]  https://www.youtube.com/watch?v=EigxHkpqJdA

Markdown语法能在哪使用？

原则上，所有网站上都可以用。但确实也有专门针对markdown进行排版使用的载体。
我们大家比较熟悉的：
  • 锤子便签
  • 简书
  • 印象笔记通过新建markdown笔记
  • GitHub
  • 马克飞象
很多人用微信公众号发文，其实也是可以用markdown格式的，把写好的文本（包括markdown标记）复制到微信公众号，然后在浏览器安装一个叫“markdown here”（Markdown Here 是一个浏览器/客户端插件，它支持GFM语法，可以一键渲染富文本编辑器中的Markdown语法，这让我们可以使用任意Web编辑器来写邮件。点我下载）
Markdown不仅可以用来渲染微信公众号的文本，还可以用来渲染邮件、自建网站内容、今日头条等。
另外，Telegram聊天窗口也支持Markdown。

有专门编写markdown的软件吗？

有！
GitHub出品的atom，专注与苹果设备的Ulysses ，以及在安卓端运行得不错的typora和中文版优化得不错的在线离线都可以编写的Cmd Markdown编辑阅读器都是不错的选择。关键是自己选定了合适的，用顺手就行。
我本人使用的是Typora，Typora和我们前面介绍的markdown形式不一样，它和word一样，也是可见即可得。也就是你打上markdown标记符号后，它就马上显示出效果来，而隐藏标记语言，只有你点击这个部分，标记语言才会显示出来。但如果你发布出去，别人在前端阅读是看不到标记语法的。同时，即便你不习惯使用标记语法，但是你喜欢用快捷键的话，也会得到和markdown语法一样的效果。
推荐使用Typora！

Markdown不能做什么

轻量文本在保证书写顺畅和格式一致性的情况下，对于需要插入进行复杂编辑、排版的文本并不适用。但是日常写写文章、编编代码还是足够用的。
同时，markdown也不能设置字体、字号、字的颜色。
​​
☎️联系我
📷加入频道
✉️邮箱

Reference

Wikipedia
JOHN GRUBER
Markdown Reference for Typora
Typora介绍
markdown完全入门(上)
markdown完全入门(下)
高阶语法手册
EMOJI CHEAT SHEET

评论

发表评论

此博客中的热门博文

Google voice申请、使用全攻略

Google voice申请、使用全攻略 什么是Google Voice？ Google Voice是谷歌公司推出的虚拟电话业务，拥有Google Voice电话，你可以用来给美国和加拿大地区的人免费发短信和打电话，以及可以用来注册国内和国外的媒体账号，比如国内的微信（转号）微博，国外的Telegram、Twitter、Facebook等。 如果你这方面的需求，推荐注册。 怎么注册Google Voice? 那么怎么注册呢？ 首先你需要满足以下三个条件： 1.有一个稳定的Google账号； 2.注册时使用美国的原生IP（节点），并且没有被别人用此IP注册过。（之所以要用美国原生IP，是因为Google voice只面向美国和加拿大地区的用户。 3.有一个可以收发短信的美国实体电话，并且这个电话不能注册过Google voice。 满足以上三个条件后，你就可以在以下网址进行Google voice号码的申请了： https://voice.google.com 不过，对于在中国的朋友来说，要满足这三个条件并不容易，因此，我们一般从淘宝买一个Google Voice的账号。购买好之后，再根据商家的操作步骤，把这个号码转移到我们的Google账号里面。在淘宝搜索“Google voice”就能买到。 Google Voice如何保号？ 注册好Google voice之后，如果有六个月没使用，Google就会取消我们这个号码的使用权，因此我们需要使用一些方法来保证自己的voice号不被销号。一般来说，会有一些保号的电报群，群成员都拥有Google voice的号码，互相发短信就行。这是一种方法。 第二种方法相比来说，更为简单，也更便捷，一劳永逸。 其实现原理是用Google voice号码注册某个网址的会员，然后订阅它们的短信通知服务，这样网站就会定期给你发送短信，以达到保号的目的。这里推荐使用https://www.bloomingdales.com/这个网站，具体操作方法，详见YouTube视频： https://www.youtube.com/watch?v=Jo1ER-P73gQ Google voice如何使用？ Google Voice的使用方法在iOS、And...
发表评论
阅读全文

购物并不是一件轻松的事情

最近发现买东西并不是一件轻松的事情，这和钱的关系不大，和是否有经验关系很大。 买东西方式很多，今天谈谈去超市买东西。 面对满目琳琅的商品，贪得无厌的本性最容易被吞噬。商家在超市的设计上也无所不用其极地使用各种招数来迎合人的本性。 比如，超市商品的位置不仅仅是按照类别分区，还在于顾客的购买频次。小孩子的东西总是放在下面，性价比高的商品也总是放在货架最下面。 因此，不仅在于丰富多样的商品，商家的 精心设计 往往也会让我们迷失在人性的本能里。 比如，以前逛超市总是喜欢边逛边买，而不是直奔一开始想买的东西的区域。于是，一场购买下来，时间延长不说，也买了很多一开始并不在计划之内的东西。 昨天去逛超市，我换了一个策略，把要买的弄一个清单，放在手机上，弄个复选框，买完一样就打个勾，买完就走，绝不多留。 你别说，还真是管用，清单大法妙！ 但是，因为这种良好管理的时刻不多，导致经验不足，还是浪费了一些时间。比如，在水果区买的水果忘记称了，买单时又返回去重新称（结账的地方和水果区相距遥远）；清单只是机械地列出来，而没有有机地分类，把同一类要买的东西放在一起，如果熟悉超市的布局，还可以按照超市的布局来排列清单的顺序；还有，如何分辨食材的新鲜度、如何买到超市最具性价比的东西、如何安排不同超市的选购策略等，都是值得研究一二的。 所以，你看，当好家庭主妇并不容易。 回到家，我就在想，我们说的 “做事有章法” ，不就是这样吗？ 和去超市买东西一样，有人只是有个需要买东西的构想和模糊的脑内购物清单（比如买一些蔬菜这种笼统的清单），但有人不仅要买的东西具体可指，还会像我上面分析的一样，采取不同的策略来把事情做好做快。考虑事情全面而系统，也许就是从这种生活小事发展而来的吧。 如果人可以分类，那么很明显可以分成“做事有章法”的人和“做事毫无章法”的人。 不仅是购物，旅游、做菜、搬家、找工作、聚餐、组织活动，就算浏览新闻、上厕所也有章法可循。 从小事构筑的一点点微小的经验，总有一天聚沙成塔，助你完成那些复杂瞩目的“大事”。 购物并不是一件轻松的事情，养成"有章可循"好习惯的人，才能过轻松的人生。 ...
发表评论
阅读全文

在值得的事情上折腾

                         最近折腾了很多事情，但最后发现，还是花钱来得舒坦。 当然，并不是钱花得越多越舒坦，这两者之间有一个临界点，不仅取决于你腰包的容量，还在于你在 “花钱” 上的经验。 就说翻墙这个事情吧，对于向往网络自由的人来说，有一个稳定、快速的翻墙工具比什么都强。无论是自建还是用别人的方案，都逃不过 “天下没有白吃的午餐” 这一真理。 “白嫖” 看似占了便宜，但长远来看，还是得不偿失。 一个人需要把自己的时间和精力看得宝贵，对它们珍视，才能得到回报。这从侧面反映， “自律给我自由” ，不仅在于文学意义上的对称，还在于逻辑上的成立。 在值得的事情上折腾，其实就是在尊重自己的时间和精力。 世界上每天都在发生形形色色的事情，它们经由编辑记者、自媒体的挑选，呈现给你一个光陆怪离的世界，这些信息铺天盖地，而且由于它们选题和用料上十足，靠谱的媒体还做到了以事实、逻辑为基础，足以吸引你的注意力。 如果我们沉浸其中，会发现这是一个黑洞，无休无止。只要活着，它们能让你一刻不休地一直看下去。 虽然它们也是真实世界的一部分，但是如果我们沉迷其中，往往看到的只是真实世界的一个面，而忽视了世界的其他面，从而否定了世界的多样性和人生的其他可能性。 我们要在循规蹈矩和放逐自我之中，找到一种平衡，这至少是一种时间花费上的平衡。 当然，平衡并不是平均，有的放矢才是人生智慧。 沉着、勇猛、有辨别、不自私。 饭前随笔于20200330
发表评论
阅读全文