- 浏览: 806031 次
- 性别:
- 来自: 株洲->深圳
文章分类
- 全部博客 (283)
- JAVA (54)
- 数据库 (25)
- Linux (22)
- Spring (9)
- Hibernate (7)
- mybatis (1)
- struts (10)
- javascript (22)
- Web (11)
- 异常 (30)
- 工具 (21)
- pay (9)
- 软件相关 (7)
- 其它 (28)
- python (1)
- 缓存 (9)
- 面试题 (2)
- 代码规范 (14)
- 网络编程 (1)
- 架构设计 (1)
- 程序测试 (3)
- 移动 (1)
- 安全 (2)
- 服务器 (4)
- 程序员 (1)
- php (4)
- 非技术 (7)
- web容器 (3)
- 竞彩篮球 (1)
- nginx (5)
- 加密 (2)
- jquery (2)
- 原理 (2)
- 项目管理 (1)
- www..betradar.com (0)
- www.betradar.com (1)
- 爬虫 (1)
最新评论
-
July01:
有一款web 打印控件StratoIO,浏览器和系统的兼容性都 ...
WEB免费打印控件推荐(4款) -
lihaimian:
你好,有个问题咨询一个,为何我在java中,无法使用与运算符, ...
位运算、异或的实际应用 -
小黄牛:
很好谢谢分享!推荐几篇spring boot基础入门文章:ht ...
Spring Boot 快速入门 (官方quick start) -
littlesheep:
我按照你的方法从新生成了密钥可是还是报者个错误...
狗日的支付宝 -
di1984HIT:
学习了~~~
javassist:增强型的java反射工具,获取方法参数名
本文面向不了解 markdown 或刚准备上手的同学。
它是什么
首先,什么是 markdown?我们可以直接看一下 WIKI……不过 wiki
很长,让人没有耐心读下去。那么,简单来说,markdown 其实是一种轻量级的标记语言;
或者说,它规定了一些文本的书写格式,就像这样:
============
开始书写正文吧
当然也可以用 *列表* 的形式:
* 列表项目
* 还是列表项目
上面这一段东西就是 markdown 了——它看上去和普通的文本没什么两样,只不过文字“被一些
标记 格式化”了,所以看上去会感觉比较漂亮,书面化一点形容叫做 具备更高的可读性
这一段 markdown 给我们的直观感受是我们能够清楚地识别出其中的“标题”、“段落”以及“列表”,
对,就和我们熟知的 html 一样,用来格式化内容
为何使用
接下来的问题自然是,我们为什么要使用 markdown?
我们可以把这个问题进一步拆分为三个问题:
- 使用 markdown 而不是 html 的好处在哪
- 在哪些场景下使用?
- 这个东西的普及度如何?(这意味着它的前途)
接下来一一回答:
-
前文已说,markdown 和 html 都是一路的标记语言,用来格式化内容。而内容之所以要显得很
格式化,是因为这样我们更容易阅读和理解。被渲染后的 html 是很可读的,但是 html 代码读起来
就很糟糕,因为它夹杂着大量<tag>
;而 markdown 不管是写还是读,都很舒服有一点需要注意的是,markdown 并不是为了取代 Html,因为根本取代不了。Markdown 的理念是,
能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式最后一点,markdown 可以被编译为 html,比如使用在线的 Pandoc
-
我个人认为,我们在 txt 上写的文档或随手记之类的东西,就完全可以使用 markdown,简单且美观
另外,最重要的一点,我们可以在 支持把 markdown 编译为 html 的地方书写 markdown,好处是
显而易见的:书写简单、展现美观。典型的场景有:github 仓库的 README 描述文件、github 中的
issue、评论框等。总而言之,把它用在要写文档的地方,妥妥的 -
我们知道,这世界上还有很多类似于 markdown 的轻量级标记语言,比如形形色色的 wiki 语法。所以,
我们凭什么使用 markdown 而不是 markup 或者 wikidown?答案很简单,因为它很流行。至少著名的程序员社区如 github 和 stackoverflow
都提供了对它的大量支持
说了那么多,结论就是,学习并且使用 markdown,必须的!何况 markdown 学起来非常简单
语法简要介绍
接下来会非常简单地介绍一下语法,而详细的语法大全可以直接去 作者的官网 查看。
作者对语法的介绍富有条理且细致入微。
语法介绍之后会着重说一下几个比较给力的特性,这个部分是重点
部分语法如下:
-
使用一个或多个空行分隔内容段来生成段落
<p>
。 -
标题(h1~h6)格式为使用相应个数的“#”作前缀,比如以下代码表示 h3:
### this is a level-3 header ### -
使用“>”作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式:
> 引用的内容
> 这个记号直接借鉴的邮件标准 -
使用“*”“+”“-”来表示无序列表;使用数字加“.”表示有序列表。如:
1. I am ordered list item 1...
2. So I should be item 2!? -
使用 4 个以上 空格或 1 个以上 的 tab 来标记代码段落,它们将被
<pre>
和<code>
包裹,这意味着代码段内的字体会是 monospace
家族的,并且特殊符号不会被转义。使用 [test](http://example.net "optional title") 来标记普通链接。
使用 ![img](http://example.net/img.png "optional title") 来标记图片。 -
引号内的 title 文字是可选的,链接也可以使用相对路径。
-
使用 * 或 _ 包裹文本产生 strong 效果:
_语气很重的文本_ 以及 **语气更重的文本**
给力的特性
-
普通换行并不产生新的段落或
<br>
,但是产生空格。其实这个和 html 对 line-break 换行 的处理方式是一致的。为了使文本良好地展示在视野内,
我们会选择 手动地 将文字折行,但是并不意味着这两行在逻辑上不是一个段落。我们也可以插入真正的手动换行符
<br>
,如果要问<br>
在什么时候有用,下面是一个例子:我
其实
是一首
诗……楼上
这一段
说得漂亮! -
支持 setext-style 的 header 定义:
-
定义 h1:
THIS IS THE MAIN TITLE
====================== -
定义 h2:
This is the subtitle
--------------------
更低级别的 header 就无法使用这种方式定义了。我们不用管 setext-style 是什么意思,只需要知道
这种标记方式更能凸显文章标题 -
-
在 blockquote(“>”标记的段落) 之内可以嵌套使用其他标签,甚至可以再嵌套
blockquote——上古神书《商古》写道:
> 今有一鼎,镌以奇文:
> > 吾乃鼎,非杯具也。 -
支持引用式的链接格式。什么叫做“引用式”的链接呢,举例来说,
对于本文中的一段文字,相应的 mkd 代码是:首先,什么是 markdown?我们可以直接看一下 [WIKI][1]……
另外,markdown 可以被编译为 html,比如使用在线的 [Pandoc][2]
[1]: http://en.wikipedia.org/wiki/Markdown "wiki_markdown"
[2]: http://johnmacfarlane.net/pandoc/try "pandoc online"看上去就好像是“引用文献”的格式一样。好处非常易见:
- 正文文本中不会出现 url 链接这种读者不关心的信息,从而不影响读者的阅读
- 链接地址可以当做一个变量,进行复用
-
支持快捷链接。一般来说,我们如果要显示一段 url 文本,最好也希望这个 url
本身能够点击。比如 http://ued.taobao.com如果使用 html,则要写作
<a href="http://ued.taobao.com">http://ued.taobao.com</a>包含了冗余信息且可读性很差,而在 mkd 中,只要写
写道<http://ued.taobao.com>就 OK 了,非常方便。
结尾
以上便是对 markdown 的一个简要介绍了,需要了解进一步内容的,请移步
来源:http://ued.taobao.com/blog/2012/07/03/getting-started-with-markdown/
发表评论
-
老陈说创业
2013-05-07 00:46 902一个创业的人,没经历过起起伏伏,餐风宿露,那不叫创业; ... -
常见的一些名词简写介绍
2012-12-13 11:43 0什么是RIA RIA(Rich Internet Ap ... -
裸奔一年机器中毒了 W32/Pate.b
2012-11-06 15:12 1614今天上班像平常一样开机,打开谷歌浏览器,但浏览器一起启就提示崩 ... -
一个阿里巴巴码农的六年回眸
2012-10-17 15:15 1453本文由淘宝开放平台 ... -
物联网
2012-10-15 16:27 1073什么是物联网? 物联网的概念是在1999年提出的。物联 ... -
一些有趣的编程名言
2012-10-15 11:01 1356以下内容收集自一些优 ... -
银行卡知识
2012-08-29 18:25 1641一、什么是银行卡: 银行卡是指由商业银行(含邮政储蓄机 ... -
收集银行卡号前六位识别发卡行和卡的种类(不全)
2012-08-29 18:23 14621622260 开头的银行卡是交通银行的太平洋卡 ... -
[转]如何获取Alexa排名数据
2012-08-28 15:05 2542上回说到Alexa的排名数据来源于Alexa工具条,所以 ... -
谷尼GoonieFilter网站内容敏感词过滤系统
2012-08-24 10:09 1868GoonieFilter网站内容敏感词过滤系统 ... -
[转]揭露Chinaz的alexa统计之一周日均访问IP估算公式
2012-08-21 23:42 2418alexa的统计数据中,最引人关注的是流量排名,除此外, ... -
[]转]武侠名字算法
2012-07-18 10:15 2260按照自己的姓名(姓/名/名)中每个字的笔画数,从下面的列表中找 ... -
从下面这个图对比,google想得更全面一些
2012-07-08 10:02 1018google: 以缩略图展示搜索链接详情页 goo ... -
比百度百科靠谱的维基百科
2012-04-15 22:41 11083月14日,大英百科 ... -
{Windows XP}自动重启问题
2012-04-13 14:20 1597{Windows XP}自动重启问题 类似 ... -
网站运营研究-王通
2012-03-18 21:51 1051通王科技 -
人生只有900个月-如何制定2012年年计划
2012-02-20 22:06 1048有人在Quora问:”最令你吃惊的事实是什么?” 他得 ... -
精彩搏击电影
2011-11-23 15:15 1046监狱:终极悍将 死刑犯 杰克·康拉德是一名死刑犯 ... -
PHP.INI配置文件位置
2011-11-16 21:09 1212windows 下装了 AppServ 默认会把php ... -
很操蛋的东西
2011-09-06 19:27 1109每次遇到些奇怪的问题,真的很奇怪,就是不对,很鸡、巴、很 ...
相关推荐
使用Java将markdown转换为pdf的简单库 ##为什么有时候,创建markdown文件的pdf版本可能会派上用场。 该库结合了其他几个库,以利用您自己转换所有内容的麻烦。 代码库保持很小,同时仍提供流畅的API。 ##先决条件...
在编写md格式的内容时,以pre标签开始和结束即可。 例如: ## chrome插件测试 * 简单的hello,world package main import "fmt" func main(){ fmt.Println("hello,world") } </pre>
当我移至自己的网站时,我开始用markdown编写博客文章,但我错过了仅复制URL(如发布推文),将其粘贴到博客文章中以及让Medium自动为我嵌入的功能。 。 此解决方案使您可以将Markdown中的链接转换为该链接的嵌入式...
先来个学习Markdown的文章, 要想学习一门语言还是要从"是什么"开始学起, 那么... ##Markdown是什么 Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式...
MarkdownToHtml 使用可自定义模板HTML转换的高度可配置的markdown。 有关详细信息,请参阅。安装与更新该模块在可用,可以从PowerShell外壳安装,如下所示: PS > Install-Module - Name MarkdownToHTML 如果模块是...
快速开始 安装 使用NPM 使用NPM软件包管理器将此依赖项添加到您的项目中。 npm i -S quill-markdown-shortcuts 使用CDN 通过jsdelivr添加库。 [removed] 通过下载文件 要将代码合并到您的代码库中,只需下载...
最好的示例表是使用原始 HTML 提供的,这很糟糕并且有点违背了使用 Markdown 开始的目的。 我还提供了一些在“纯”降价和 LaTeX 中生成的表格的更简单示例。 LaTeX 版本需要使用更严格的“数组”环境而不是“表格”...
快速开始$ npm install @uiw/react-markdown-preview --save使用范例 import MarkdownPreview from '@uiw/react-markdown-preview' ;const source = `## MarkdownPreview> todo: React component preview markdown ...
最初的Markdown源代码是用Perl编写的,并大量使用了Lua的简单正则表达式引擎中不提供的高级正则表达式技术(例如,负向超前等)。 因此,此Lua端口已从头开始重写。 它可能不是完全没有错误。 如果您发现任何错误,...
开始, 1.安装Markdown甲板。一旦安装,您应该在浏览器的工具栏中看到Markdown Deck图标 2.在Chrome浏览器中转到此链接https://raw.githubusercontent.com/ragrawal/flashcards-chrome/master/readme.md 3.点击...
刚开始转的时候,还没啥,转得次数多了,就觉得不能继续这样下去了。作为一名开发人员,还是让机器去做这些琐碎的事情吧。故写了两个脚本将md文件转成html文件,并将其放置在web服务器下,方便其他人员阅读。 主要...
复制选择为Markdown 复制标题,URL,选择为Markdown安装转到并安装。用法右键单击并选择: 当选择了页面的一部分:复制选择为降价用户上下文单击页面时:将标题和URL复制为Markdown 当用户上下文单击链接时:将链接...
markdown-resume.js ... 产品特点 通过wkhtmltopdf生成PDF 多种设备视口尺寸的自适应设计 简单的Markdown格式 快速开始 生成的文件将与源文件放在同一目录中。 # For usage on the command line ...使用Docker运行
雨果当 hugodown是一个实验性软件包,旨在促进和一起使用。... 与Blogdown相比 仅在您明确要求时(通过编织帖子),它才重新运行R代码。这使得hugodown在长期运行的博客...它是围绕一种Rmarkdown格式.Rmd 。 安装 hugodo
语言:English 粘贴为Markdown。 以任何Web形式将剪贴板的内容粘贴为Markdown。 剪贴板的内容可以来自任何地方(文本编辑器,图形...新增功能(从5.7.2开始):现在可以解释粗体和斜体的内联样式(适用于Google文档等)
欢迎使用Ink,这是一种用Swift编写的快速灵活的Markdown解析器。 它可用于将Markdown格式的字符串转换为HTML,还支持元数据解析,以及强大的自定义选项...将Markdown转换为HTML要开始使用Ink,您要做的就是导入并使用它
柔和的 :artist_palette: Pastel是一个用于从Markdown生成漂亮的API文档的工具。 用Markdown编写文档,然后让Pastel将其转换为HTML页面,并完成以下操作: ...从一个Markdown文件开始。 有两个部分: 内容 您的M
Python讲义 使用Markdown注释和嵌入式数字将Python脚本转换为讲义。 支持任何文本编辑器的无隐藏状态的Jupyter笔记本的替代产品。 码讲义入门您可以将Python讲义用作普通Python程序中的库: 通过pip3 install -U ...
输出格式特别适合复制粘贴到:快速开始安装python软件包: pip install -r requirements.txt转换示例注释: kindle_notes_to_md.py example_notebook.html然后,您可以在自己喜欢的文本编辑converted.md中打开...
这是在线降价编辑器/查看器。 这可以帮助您利用网络技术来编辑...要将markdown转换为html,Markdown-Edit默认使用 。 原始API不是基于JSON的。 它需要将Markdown文档作为纯text/plain text/x-markdown或text/x-markdow