这是一篇讲解如何正确使用 Markdown 的排版示例,学会这个很有必要,能让你的文章有更佳清晰的排版.
引用文本:Markdown is a text formatting syntax inspired
Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式,被广泛使用.简书是最先一批支持 markdown 的写作社区.
一:普通内容
这段内容展示了在内容里面一些小的格式,比如:
加粗 - ** 加粗 **
倾斜 - * 倾斜 *
删除线 - ~~ 删除线~~
Code 标记 - Code 标记
超级链接 -
[超级链接](http://github.com)
如何实现:
username@gmail.com -
[username@gmail.com](mailto: username@gmail.com)
- **加粗** - `**加粗**`
- *倾斜* - `*倾斜*`
- ~~删除线~~ - `~~删除线~~`
- `Code 标记` - ``Code 标记``
- [超级链接](http://github.com) - `[超级链接](http://github.com)`
- [username@gmail.com](mailto:username@gmail.com) - `[username@gmail.com](mailto:username@gmail.com)`
二:提及用户
@foo @bar @someone ... 通过 @ 可以在发帖和回帖里面提及用户,信息提交以后,被提及的用户将会收到系统通知.以便让他来关注这个帖子或回帖.
三:表情符号 Emoji
支持表情符号,你可以用系统默认的 Emoji 符号(无法支持 Windows 用户).
也可以用图片的表情,输入 : 将会出现智能提示.
四:一些表情例子
:smile: :laughing: :dizzy_face: :sob: :cold_sweat: :sweat_smile: :cry: :triumph: :heart_eyes: :relaxed: :sunglasses: :weary:
放下效果截图
markdown_0.png
五:大标题 - Heading 3
你可以选择使用 H2 至 H6,使用 ##(N) 打头,H1 不能使用,会自动转换成 H2.
NOTE: 别忘了 # 后面需要有空格!
如何实现:
Heading 4
Heading 5
Heading 6
六:图片
#### Heading 4
##### Heading 5
###### Heading 6
![alt 文本](http://image-path.png)
![alt 文本](http://image-path.png "图片 Title 值")
![设置图片宽度高度](http://image-path.png =300x200)
![设置图片宽度](http://image-path.png =300x)
![设置图片高度](http://image-path.png =x200)
( http://image-path.png ) 我们如何来获得呢?
1. 首先把所要上传的 image 上传到 github 上
markdown_1.png
2. 点击 download 按钮
markdown_2.png
3. 复制所打开浏览器的链接地址
markdown_3.png
例子
![alt 文本](https://raw.githubusercontent.com/railsbigboy/resource_share/master/java/微信管理-1.png)
七:代码块
普通
语法高亮支持
*emphasize* **strong**
_emphasize_ __strong__
@a = 1
如果在 ``` 后面更随语言名称,可以有语法高亮的效果哦,比如:
演示 Ruby 代码高亮
演示 Rails View 高亮
class PostController < ApplicationController
def index
@posts = Post.last_actived.limit(10)
end
end
演示 YAML 文件
<%= @posts.each do |post| %>
<div class="post"></div>
<% end %>
zh-CN:
name: 姓名
age: 年龄
Tip: 语言名称支持下面这些: ruby, python, js, html, erb, CSS, coffee, bash, json, yml, xml ...
八:有序,无序列表
无序列表
有序列表
Ruby
Rails
ActiveRecord
Go
Gofmt
Revel
Node.js
Koa
Express
- Ruby
- Rails
- ActiveRecord
- Go
- Gofmt
- Revel
- Node.js
- Koa
- Express
九:表格
Node.js
Express
Koa
Sails
Ruby
Rails
Sinatra
Go
1. Node.js
1. Express
2. Koa
3. Sails
2. Ruby
1. Rails
2. Sinatra
3. Go
如果需要展示数据什么的,可以选择使用表格哦
十:段落
header 1 header 3
cell 1 cell 2
cell 3 cell 4
cell 5 cell 6
| header 1 | header 3 |
| -------- | -------- |
| cell 1 | cell 2 |
| cell 3 | cell 4 |
| cell 5 | cell 6 |
留空白的换行,将会被自动转换成一个段落,会有一定的段落间距,便于阅读.
请注意后面 Markdown 源代码的换行留空情况.
或者可以用 <br/> 这个标签也可以换行
其他:视频插入
目前支持 Youtube 和 Youku 两家的视频插入,你只需要复制视频播放页面,浏览器地址栏的网页 URL 地址,并粘贴到话题/回复文本框,提交以后将自动转换成视频播放器.
例如
Youtube https://www.youtube.com/watch?v=CvVvwh3BRq8 Vimeo https://vimeo.com/199770305 Youku http://v.youku.com/v_show/id_XMjQzMTY1MDk3Ng==.html 如何实现:
**Youtube**
https://www.youtube.com/watch?v=CvVvwh3BRq8
**Vimeo**
https://vimeo.com/199770305
**Youku**
http://v.youku.com/v_show/id_XMjQzMTY1MDk3Ng==.html
来源: http://www.jianshu.com/p/59537dc2b88a