Markdown 简明语法

Posted 2020-12-02 zjcao

Guide

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

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

语法指导

普通内容

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

• 加粗 - **加粗**
• 倾斜 - *倾斜*
• 删除线 - ~~删除线~~
• Code 标记 - Code 标记``
• Github网站连接 - [Github网站连接](http://github.com)
• [email protected] - [[email protected]](mailto:[email protected])
• 高亮显示 - <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文件