Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

高逼格文档标记语言-Markdown入门 #1

Open
kuitos opened this issue May 19, 2015 · 7 comments
Open

高逼格文档标记语言-Markdown入门 #1

kuitos opened this issue May 19, 2015 · 7 comments
Labels

Comments

@kuitos
Copy link
Owner

kuitos commented May 19, 2015

高逼格文档标记语言-markdown入门

接触markdown还挺早,主要是github上的readme都是markdown写的。但是之前都是在很小儿科的用markdown写东西,今天来系统学习下😄

markdown简介:

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。[1]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

Markdown同时还是一个由Gruber编写的Perl脚本:Markdown.pl。它把用markdown语法编写的内容转换成有效的、结构良好的XHTML或HTML内容,并将左尖括号('<')和&号替换成它们各自的字符实体引用。它可以用作单独的脚本,Blosxom和Movable Type的插件又或者BBEdit的文本过滤器.[1]

Markdown也已经被其他人用Perl和别的编程语言重新实现,其中一个Perl模块放在了CPAN(Text::Markdown)上。它基于一个BSD风格的许可证分发并可以作为几个内容管理系统的插件。

基本

  • 换行 行末两个空格 & 回车键

  • header

    Header
    =================
    
    or
    
    Header
    -----------------
    
  • 分级header

    # header
    ## header
    ### header
    #### header
    
  • 无序列表

    * 第一个
    * 第二个
    * 第三个
    
  • 有序列表

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

语法

  1. 字体

    • 加粗 **like this** like this
    • 斜体 *like this* like this
  2. 图片 ![Alt Image Text](path/or/url/to.jpg "Optional Title")MacDown logo

  3. 链接 Markdown Site[Markdown Site](http://daringfireball.net/projects/markdown/syntax) or [Markdown Site][1]

  4. email kuitos.lau@gmail.com <kuitos.lau@gmail.com>

  5. 文章块引用

    第一层引用

    第二层引用

    > 第一层引用
    >> 第二层引用   
    
  6. inline code inline code

  7. 水平分隔线 --- or ***


  8. 表格

    左对齐 居中 右对齐
    第一行 他大舅 $1600
    第二行 他二舅 $12
    第三行 都是他舅 $1
    | 左对齐  | 居中  | 右对齐 |
    |:------ |:--------:| -----:|
    | 第一行  | 他大舅    | $1600 |
    | 第二行  | 他二舅    | $12   |
    | 第三行  | 都是他舅  |  $1   |
    
  9. 大招来了 代码块高亮 code block后加上语言名即可

    var object = {};
    function fn(){}
    console.log("Hello World");
    ~~~js
    var object = {};
    function fn(){}
    console.log("Hello World");
    

更多markdown语法请访问markdown site github markdown

MIT

@kuitos kuitos changed the title markdown入门 Markdown入门 May 19, 2015
@kuitos kuitos added the blog label May 19, 2015
@kuitos kuitos changed the title Markdown入门 高逼格文档标记语言-Markdown入门 May 19, 2015
@kuitos kuitos added 工具 and removed blog labels Aug 23, 2015
@arzyu
Copy link

arzyu commented Nov 6, 2015

@kuitos 分级header 那个地方好像少了空格,像这样

# header
## header
### header
#### header

@kuitos
Copy link
Owner Author

kuitos commented Nov 6, 2015

@arzyu 是的,已修复👍

@Jocs
Copy link

Jocs commented Dec 1, 2018

~~~js
var object = {};
function fn(){}
console.log("Hello World");

需要使用 ~~~ 结束 code block?

~~~js
var object = {};
function fn(){}
console.log("Hello World");
~~~

是这样的吗?

@Jocs
Copy link

Jocs commented Dec 1, 2018

换行 行末两个空格 & 回车键

哈哈,是否加两个空格可以明确一些,hard line break 和 soft line break,https://github.github.com/gfm/#hard-line-break。

@kuitos
Copy link
Owner Author

kuitos commented Dec 3, 2018

@Jocs 这么老的文章都能被挖出来😂

@Jocs
Copy link

Jocs commented Dec 3, 2018

大佬的文章 要时常阅读,温故知新!

@kuitos
Copy link
Owner Author

kuitos commented Dec 3, 2018

@Jocs 那会还是个菜鸡:joy:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants