搜索
查看: 714|回复: 1

[Other] Markdown + pandoc

[复制链接]

12

主题

18

帖子

151

积分

注册会员

Rank: 2

积分
151
发表于 2018-11-12 10:56:32 | 显示全部楼层 |阅读模式
1. 写在前面:GitHub 上所有关于项目的介绍、Wiki以及之后在GitHub上搭建个人博客都是基于Markdown 语法,不可避免要学习markdown。学习资源见Markdown,以下内容均根据学习链接的资源进行摘要性记录。


2. Markdown基本语法:
    2.1 粗体/斜体
    *这是斜体* (被解释为<em>斜体</em>)
    _这也是斜体_ (被解释为<em>斜体</em>)
    **这是粗体**  (被解释为<strong>粗体</strong>)
    ***这是粗体+斜体***  (被解释为<strong><em>粗体+斜体</strong></em>)
    2.2 删除线
    ~~删除线~~ (被解释为<strike>删除线</strike>,非markdown经典要素,仅部分编辑器支持)
    2.3 标题
    markdown支持共六级标题
    # H1 #
    ## H2 ##
    ...
    ###### H6 ######
    2.4 引用
    通过在行首加上>来添加引用格式,如
    > This is the first line
    >
    > 1. xx
    > 2. xx
    >
    > examples
    2.5 列表
    2.5.1 无序列表
    * headline
    + headline
    or - headline
    2.5.2 有序列表 (数字 + 英文句点)
    1. 1st
    2. 2nd
    3. 3rd
    注:数字不会影响HTML的输出效果,上面例子等同于
    1. 1st
    1. 2nd
    3. 3rd
    2.6 内联代码
    以反引号`标记内联代码,被解释为<code>。若代码中有反引号,以两个反引号转义一个反引号。代码中的&、<、>符号则自动转义。
    2.7 代码区域
    2.7.1 以行首缩进四个空格
    示例:
        代码区块
    2.7.2 GitHub标记代码区块的方法,代码区块前后用三个反引号独占一行来标记代码区块
    ```
    代码区块
    ```
    2.8 分割线(以下几种方法均可用以建立分割线,三个及以上的*、-或底线_)
    ***
    -----
    * * * (符号间可以插入空格)
    _ _ _ _ _ _ _ _ _ _ _ _ _ _
    2.9 链接
    [an example](http://example.com/)
    [an example](http://example.com/ "Optional Title")
    2.10 图像
    ![Alt text](/path/to/img.jpg)   
    ![Alt text](/path/to/img.jpg "Optional Title")
    2.11 转义 (markdown支持在以下字符前插入反斜杠,即原样输出字符)
    \  `  *  _  {}  []  ()  #  +  -  .  !
    2.12 表格(GitHub独有的风格)
    必须有一行| :------- | ----: | :---: |,其中的冒号决定了居左居右居中。
    | col1   | col2 | col3|
    | :------- | ----: | :---: |
    | x        | y      | z    |
    会被解释为
    <table>
    <thead>
    <tr>
    <th align="left">col1</th>
    <th align="right">col2</th>
    <th align="center">col3</th>
    </tr>
    </thead>
    <tbody><tr>
    <td align="left">x</td>
    <td align="right">y</td>
    <td align="center">z</td>
    </tr>
    </tbody></table>
    2.13 内联HTML:标签中的*等作为构成html标签和实体的符号,不会做任何转义。
3. 高级语法
    3.1 定义列表
    Term 1
    Term 2
    :    Definition A
    :    Definition B
    3.2 目录
    通过[TOC]标记插入目录。
    3.3 TeX公式
    通过一个$符号或两个$符号分别引入一行公式或一个公式块,如
    $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
    $$
    \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
    $$
在需要插入公式的地方用<script>标签包裹公式,如<script type="math/tex">\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N</script>
4. pandoc 文件转换瑞士军刀

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x



上一篇:慧美——R for data science 第九章 使用dplyr处理关系数据
下一篇:&lt;R for Data Science&gt; 读书笔记7 | 第十一章: Data import
回复

使用道具 举报

12

主题

18

帖子

151

积分

注册会员

Rank: 2

积分
151
 楼主| 发表于 2018-11-12 10:58:36 | 显示全部楼层
本帖最后由 冒刷 于 2018-11-12 11:07 编辑



1. Pandoc is often used to convert doc in markdown, HTML, LaTeX, MediaWiki markup, Twiki markup, MS word, etc to HTML, word, LaTeX, PDF, etc.
2. Applications: 可运用例如pandoc -f html -t markdown实现markdown的文件转换输出,不必过于熟悉markdown语法即可速成R markdown的语法内容填充。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|手机版|小黑屋|生信技能树 ( 粤ICP备15016384号  

GMT+8, 2019-8-19 14:45 , Processed in 0.031202 second(s), 26 queries .

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.