Markdown


Markdown

Markdown 是一种轻量级标记语言。

它允许人们“使用易读易写的纯文本格式编写文档,

然后转换成有效的其他文档。

块级元素

  • 段落
  • 标题
  • 引用
  • 列表
  • 表格
  • 代码块
  • 分割线

段落

由一个或多个连续的文本行组成。
空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行
普通段落不该用空格或制表符来缩进。  

    标题

    一级标题
    =======
    二级标题-------
    或者
    # 一级标题
    ## 二级标题
    ### 三级标题

    #### 四级标题

    引用

    > 这是> 一个> 引用段落。 >> 这个也是。

    > 我可以偷懒。
    > > 我可以嵌套。> ## 可以使用标题。
    > 
    > 1. 使用列表。
    > 2. 使用列表。
    > 
    > 使用代码:
    > 
    >     return shell_exec("echo $input | $markdown_script");

    列表

    * 无序列表项* 无序列表项
    + 无序列表项+ 无序列表项
    - 无序列表项- 无序列表项
    1. 有序列表项
    3. 有序列表项
    7. 数字可以任意顺序
    7. 数字可以重复
    6. 可以包含多个段落。
        
        可以包含多个段落,但是要缩进4个空格。     > 包含引用的话,也要缩进4个空格哦。        return 10; // 包含代码的话要缩进两次哦。

    表格

    |表头     | 表头   |
    |--------|--------|
    |单元格   | 单元格 |
    |单元格   | 单元格 |

    表头   | 表头 --------|-------- 单元格 | 单元格 单元格   | 单元格
    |表头   | |--------| |单元格 | |单元格   |


    代码块

    这是一个普通段落:
    print('hello') -- 这是一个代码块。

    分隔线


    * * *
    
    ***
    
    *****
    
    - - -
    
    --------------------------------------- 

    内联元素

    • 链接
    • 强调
    • 代码
    • 图片

    链接

    这是一个[链接](http://example.com) 这是一个站内[链接](/abc.html)参考式的[链接][id],这个id是不区分大小写的。
    隐式链接标记,比如[Google][]。

    [id]: http://example.com/
    [Google]: http://www.google.com

    强调

    *单个星号* 产生斜体字
    
    _单个下划线_ 产生斜体字
    
    **两个星号** 产生粗体字
    
    __两个下划线__ 产生粗体字 
    如果星号和下划线两边有空白就会被当成普通字符。

    代码

    如果要标记`一小段行内代码`,你可以用反引号把它包起来。 

    图片

    ![](/path/to/img.jpg)
    ![](http://www.example.com/img.jpg)
    ![][id]
    
    
    [id]: http://www.example.com/img.jpg 

    反斜杠


    可以利用反斜杠来插入一些在语法中有其它意义的符号。

    \   反斜线
    `   反引号
    *   星号
    _   下划线
    {}  花括号
    []  方括号
    ()  括弧
    #   井号
    +   加号
    -   减号
    .   英文句点
    !   惊叹号|   竖线

    Redmine Markdown

    • Redmine链接
    • 区别

    REDMINE 链接

    问题 #7123问题的注解 #7123-1
    wiki链接 [[产品规格写作规范]]wiki章节链接 [[产品规格写作规范#示例]]wiki链接,使用替代的名字 [[产品规格写作规范|Spec规范]]wiki跨项目链接 [[doc:产品规格写作规范]]
    wiki跨项目链接到wiki主页 [[doc:]]

    文档链接,通过编号 document#1文档链接,通过标题 document:签核打印文档模板文档链接,通过标题 document:"如有 空格则需要引号"
    文档链接,通过标题 doc:document:签核打印文档模板


    Redmine 链接(续)

    版本 version#1版本 version:1.0.0版本 version:"1.0.0 beta 1"版本 ios:version:7.1
    附件 attachment:abc.zip
    论坛消息 message#1
    项目 project:文档项目 project:doc
    转意 !version#1  ![[页面名字]] 

    区别

    • 连续行间的换行会保留。
    • 其他,细节或者bug。

    例子

    示例

    编辑器

    Sublime Text + Markdown Preview

    就这些!

    问题?

    Markdown

    By xpol

    Markdown

    • 1,031