Markdown 简明语法

Guide

这是一篇讲解如何正确使用Markdown的排版示例,学会这个能让你的文章有更清晰的排版。

引用文本: Markdown is a text formatting syntax inspired

语法指导

普通内容

这段内容展示了在内容里面一些小的格式,比如:

  • 加粗 - **加粗**
  • 倾斜 - *倾斜*
  • 删除线 - ~~删除线~~
  • Code 标记 - \Code 标记``
  • Github网站连接 - [Github网站连接](http://github.com)
  • username@gmail.com - [username@gmail.com](mailto:username@gmail.com)
  • 高亮显示 - <mark>高亮显示</mark>

提及用户

@abc @ def @hij ... 通过@可以在发贴和回帖里提及用户,信息提交后,被提及的用户将会收到系统通知。以便让他们来关注这个帖子或回帖。

表情符合 Emoji

Markdown支持表情符号,你可以用系统默认的 Emoji 符号(注:Windows用户无法使用)。也可以使用图片的表情,输入: 将会出现智能提示。

一些表情例子

😄 😆 😵 😭 😰 😅 😢 😤 😍 ☺️

:smile: :laughing: :dizzy_face: :sob: :cold_sweat: :sweat_smile: :cry: :triumph: :heart_eyes: :relaxed:

😎 😩 👍 👎 💯 👏 🔔 🎁 ❓ 💣

:sunglasses: :weary: :+1: :-1: :100: :clap: :bell: :gift: :question: :bomb:

❤️ ☕ 🌀 🙇 💋 🙏 💦 💩 ❗ 💢

:heart: :coffee: :cyclone: :bow: :kiss: :pray: :sweat_drops: :hankey: :exclamation: :anger:

大标题 - heading 3

你可以选择使用 H2 至 H6,使用 ##(N) 打头,H1 不能使用,会自动转换成 H2。

NOTE: 别忘了 # 后面需要添加一个空格

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)

代码块

普通

*emphasize*    **strong** 
_emphasize_    __strong__ @a = 1

语法高亮支持

如果在 ``` 后面更随语言名称,可以有语法高亮的效果哦,比如:

演示 Java 代码高亮
public class Hello {
	public static void main(String[] args) {	
		System.out.println("Hello Java!");	
	}
}
演示 Ruby 代码高亮
class PostController < ApplicationController
  def index
    @posts = Post.last_actived.limit(10)
  end
end
演示 Rails View 高亮
<%= @posts.each do |post| %>
<div class="post"></div>
<% end %>

Tip: 语言名称支持下面这些: ruby, python, js, html, erb, css, coffee, bash, json, yml, xml ...

有序、无序列表

无序列表

  • Ruby
    • Rails
    • ActiveRecord
  • Go
    • Gofmt
    • Revel
  • Node.js
    • Koa
    • Express

有序列表

  1. Node.js
    1. Express
    2. koa
    3. Sails
  2. Ruby
    1. Rails
    2. Sinatra
  3. Go

表格

如果需要展示数据,可以选择使用表格。

Header 1 Header 2 Header 3
cell 1 cell 2 cell 3
cell 4 cell 5 cell 6
cell 7 cell 8 cell 9

段落

留空白的换行,将会被自动转换成一个段落,会有一定的段落间距,便于阅读。

请注意后面 Markdown 源代码的换行留空情况。

视频插入

你只需要复制视频播放代码,并粘贴到正文,提交以后将自动转换成视频播放器。

Youtube视频代码示例

<iframe width="560" height="315" src="https://www.youtube.com/embed/OHcOyZl8iHY" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>

Youtube视频插入效果

插入PDF文件

posted @ 2018-07-06 18:53  zjcao  阅读(479)  评论(0编辑  收藏  举报