Markdown 是一种轻量级标记语言,创始人为 John Gruber 和 Aaron Swartz。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML/HTML 文档”
OSC 博客已支持使用Markdown书写,可以在发表博文的时候点编辑器右上方的切换按钮一键切换编辑器或者到 空间管理-博客管理-博客设置 处设置默认编辑器。
本文简单介绍下 Markdown 的基本语法,让初学者可以快速入门并使用这种标记语言。
标题
标题(h1~h6)可使用相应个数的#来生成,如下面的代码将会生成h3:
### this is a level-3 header ###
或者使用底线形式,利用=(最高阶标题)和-(第二阶标题):
This is an H1 ============= This is an H2 -------------
段落和换行
使用一个或多个 空行 分隔内容段来生成段落 (<p>)
在行末输入2个或以上 空格 再回车来生成换行(<br>)
强调
被1个*或_包围起来的文字将会被<em>标签包围:
*single asterisks* _single underscores_
被2个*或_包围起来的文字将会被<strong>标签包围:
**double asterisks** __double underscores__
注:如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
分隔线
在一行内使用3个以上的*-或_来建立 分隔线 (<hr>),行内除此之外不能有其它内容:
* * * *** ***** - - - ---------------------------------------
区块引用
使用>作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式:
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, > consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. > Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse > id sem consectetuer libero luctus adipiscing.
列表
使用*+-来表示无序列表<ul>:
* Red * Green * Blue
使用数字紧跟一个 英文句点 .来表示有序列表ol:
1. Bird 2. McHale 3. Parish
代码
使用 反引号 (`)(在键盘上位于1的左边)把文字括起来来表示行内代码,这段文字将会被<code>标签包围:
Use the `printf()` function.
使用4个 空格 或1个 制表符 (Tab)缩进来表示代码区块,它们将被<pre>和<code>标签包裹起来,在代码区块里面的&<和>会自动转成 HTML 实体:
<div class="footer"> © 2004 Foo Corporation </div>
链接
行内式语法:
This is [an example](http://example.com/ "Title") inline link. [This link](http://example.net/) has no title attribute.
参考式语法:
This is [an example][id] reference-style link. [id]: http://example.com/ "Optional Title Here"
注:下面的链接定义,你可以把它放到文章的任意位置。
自动链接:
<http://example.com/>
隐式链接标记:
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][]. [google]: http://google.com/ "Google" [yahoo]: http://search.yahoo.com/ "Yahoo Search" [msn]: http://search.msn.com/ "MSN Search"
图片
图片的语法和链接比较相似,也有 行内式 和 参考式 两种。
行内式语法:
![Alt text](/path/to/img.jpg) ![Alt text](/path/to/img.jpg "Optional title")
参考式语法:
![Alt text][id] [id]: url/to/image "Optional title attribute"
注:到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的<img>标签。
转义字符
可以利用反斜杠来插入一些在语法中有其它意义的符号:
\*literal asterisks\*
Markdown支持的转义字符列表:
\ 反斜线 ` 反引号 * 星号 _ 底线 {} 花括号 [] 方括号 () 括弧 # 井字号 + 加号 - 减号 . 英文句点 ! 惊叹号
其它
书写表格: Markdown 并没有提供表格语法,但你可以像写 HTML 那样使用标签来书写表格,但要注意 HTML 标签内的 Markdown 表达式将不会被解析。
代码高亮: 这不在Markdown支持的范围之内,OSC 的 Markdown 编辑器支持代码高亮,你可以在代码上方使用<!--lang: java-->或lang: java的形式来指定编程语言,这样文章在显示的时候会使用 SyntaxHighlighter 自动按照指定的语言进行语法着色。
Markdown资源
- Markdown 项目主页
- Markdown 语法说明(中文版)
- Markdown 工具:
- Windows:MarkdownPad, MEditor
- Linux:ReText
- Mac:Mou
- Chrome插件:Made, Markdown Here
- Sublime Text 2: 跨平台编辑器,可通过插件支持Markdown
- Pandoc: 强大的文本编译工具,支持各种文档格式互转
暂时就这么多吧,欢迎大家继续补充!
来源:http://www.oschina.net/question/100267_75314
相关推荐
Markdown快速入门.pdf Markdown快速入门.pdf Markdown快速入门.pdf
Markdown快速入门(typora).md
markdown语法可以用于在网页上方便的书写文档,常用的场合为在GitHub上写readme文档,本文简要总结了markdown最基础的语法,并附上了示例图片
markdown入门,arkdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等)...
该资源提供了学习Markdown必备的语法资料。通过该资料,新手可快速上手利用markdown提高文档的编写效率。
markdown基础学习,可以快速markdown入门,学习和了解一些简单的语法。时间短并且高效,可以相互学习
Nuxt + Markdown博客入门 这不是一个官方项目。 它是由,您可以提交拉取请求。 :high_voltage: 生活 :sparkles: 快速开始 克隆此存储库。 git clone ...
想要了解并学习 Markdown 的同学可以来看看,知识点总结的还是很全的,可以快速入门。
安装快速入门(假设您具有所有必要的依赖项): 通过运行以下任一命令来安装小型服务器: [sudo] npm -g install instant-markdown-d或(对于预发行版本): [sudo] npm -g install instant-markdown-d@next 或者: ...
快速入门$ npm install @ uiw / react-markdown-preview --save使用示例从'@ uiw / react-markdown-preview'导入MarkdownPreview; const source =`## MarkdownPreview>待办事项:React组件预览markdown文本。 `; ...
25集Flask入门教程,带源码。Python Web入门Flask。 实战Flask编程一个简单的markdown博客网页。
[MD]unmerisMorrowind 的翻译入门指南和 Markdown 项目在上Markdown 是一种纯文本语言,可以非常轻松地编写格式化文档。 也可以使用内联 HTML 在 Markdown 中调用自定义字体。 通过结合一种可用的在线方言,可以非常...
VuePress快速入门指南 这是Packt发行的的代码库。 利用Vue.js的力量构建快速的静态网站 这本书是关于什么的? 什么是静态网站生成器,为什么需要它们,它们比一般的博客或写作或内容工具更好吗? 当您学习如何...
欢迎来到Alloy快速入门 我们创建了客户旅程的精选故事,以帮助您导航API 只需编写漂亮的API文档。 查阅。 Alloy快速入门入门 先决条件 您将需要: 对,就是那样! 设定 使用git clone ...
查看以快速入门。 将此存储库到您自己的GitHub帐户,然后其到本地设备安装依赖项: yarn 构建代码并注意更改: yarn watch 在新选项卡中,启动应用程序: yarn start 如果要为指定平台构建二进制文件,请运行以下...
:eyes:先决条件:high_voltage:快速入门:sparkles:使用示例:rocket:功能:bomb:下一步:glowing_star:贡献:person_bowing:作者:books:许可证:red_question_mark:关于这个简单的CLI可以帮助您从头开始引导自述文件和许可...
Nuxt + Markdown博客入门 这不是一个官方项目。它是由,您可以提交拉取请求。 :high_voltage:居住 :sparkles:快速开始 克隆此存储库。 git clone https://github.com/marinaaisa/nuxt-markdown-blog-starter.git...
Alibaba nacos于2018年7月开源,并开始逐步拥抱springcloud社区,alibaba微服务框架大有超越之势,目前热度非常高,其中注册中心nacos就像人之心脏,值得分享与学习下,课件markdown资料及课程源码都已经上传。
盖茨比Markdown入门 基于markdown的网站(文档,博客等)的样板。 基于 。 特征 响应式网页设计 侧边栏 锚 去做 页脚 搜索功能 更多例子 外挂程式 盖茨比图像 gatsby-plugin-manifest gatsby-plugin-offline ...
项目描述:《Python 3.6入门教程:草根学Python》 本项目致力于为初学者提供一套完整的Python学习资源,基于Python 3.6版本。...本教程通俗易懂,适合广大草根阶层学习Python编程,助力编程新手快速入门和提高。