Markdown标记语法使用介绍



  • 1. Markdown是什么

    Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。
    Markdown也可以理解为将以MARKDOWN语言编写的语言转换成HTML内容的工具,最初是一个perl脚本Markdown.pl

    2. 为什么要使用它?

    • 它是易读(看起来舒服)、易写(语法简单)、易更改纯文本。处处体现着极简主义的影子。
    • 兼容HTML,可以转换为HTML格式发布。
    • 跨平台使用。
    • 越来越多的网站支持Markdown。
    • 更方便清晰的组织你的电子邮件。(Markdown-here, Airmail)
    • 摆脱Word。

    3. 怎么使用?

    如果不算扩展,Markdown的语法绝对简单到让你爱不释手。

    废话太多,下面正文,Markdown语法主要分为如下几大部分:
    标题段落区块引用代码区块强调列表分割线链接图片反斜杠 \符号’`’

    3.1 标题

    使用#,可表示1-6级标题。

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题

    效果:

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

    3.2 段落

    段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。

    3.3 区块引用

    在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:

    > 区块引用
    >> 嵌套引用

    效果:

    区块引用

    嵌套引用

    3.4 代码区块

    代码区块的建立是使用```。如

    代码:

    ```
    void main()    
    {    
        printf("Hello, Markdown.");    
    }
    ```
    

    效果:

    void main()
    {
        printf("Hello, Markdown.");
    }
    

    注意:需要和普通段落之间存在空行。

    3.5 强调

    在强调内容两侧分别加上*,如:

    *斜体*
    **粗体**

    效果:

    斜体
    粗体

    3.6 列表

    使用·+、或-标记无序列表,如:

    -(+*) 第一项
    -(+*) 第二项
    - (+*)第三项

    注意:标记后面最少有一个_空格_或_制表符_。若不在引用区块中,必须和前方段落之间存在空行。

    效果:

    • 第一项
    • 第二项
    • 第三项

    有序列表的标记方式是将上述的符号换成数字,并辅以.,如:

    1 . 第一项
    2 . 第二项
    3 . 第三项

    效果:

    1. 第一项
    2. 第二项
    3. 第三项

    3.7 分割线

    分割线最常使用就是三个或以上*,还可以使用-_

    3.8 链接

    链接可以由两种形式生成:行内式参考式
    行内式

    [younghz的Markdown库](https:://github.com/younghz/Markdown “Markdown”)。

    效果:

    younghz的Markdown库

    参考式

    [younghz的Markdown库1][1]
    [younghz的Markdown库2][2]
    [1]:https:://github.com/younghz/Markdown “Markdown”
    [2]:https:://github.com/younghz/Markdown “Markdown”

    效果:

    younghz的Markdown库1
    younghz的Markdown库2

    注意:上述的[1]:https:://github.com/younghz/Markdown "Markdown"不出现在区块中。

    3.9 图片

    添加图片的形式和链接相似,只需在链接的基础上前方加一个

    3.10 反斜杠\

    相当于反转义作用。使符号成为普通符号。

    3.11 符号’`’

    起到标记作用。如:

    `ctrl+a`

    效果:

    ctrl+a

    其它

    列表的使用(非traditonal markdown):

    |表示表格纵向边界,表头和表内容用-隔开,并可用:进行对齐设置,两边都有:则表示居中,若不加:则默认左对齐。

    代码库 链接
    MarkDown https://github.com/younghz/Markdown
    moos-young https://github.com/younghz/moos-young

    关于其它扩展语法可参见具体工具的使用说明。



  • 目前这个字体真的丑



  • @Arron 可以调可以调,大哥你说要什么样的?



  • 社区里面有 MathJax 支持么?



  • @Xuanwo 改成以前那样的



  • @quxiaofeng 可以有,不过近期没有添加的计划



  • @Arron 恩,我再调一调


登录后回复
 

与 青云QingCloud 社区 的连接断开,我们正在尝试重连,请耐心等待