{"id":15038198,"url":"https://github.com/younghz/markdown","last_synced_at":"2025-04-12T01:55:06.996Z","repository":{"id":16454061,"uuid":"19205962","full_name":"younghz/Markdown","owner":"younghz","description":"Markdown 基本语法。","archived":false,"fork":false,"pushed_at":"2023-07-30T09:24:10.000Z","size":213,"stargazers_count":3777,"open_issues_count":5,"forks_count":1935,"subscribers_count":92,"default_branch":"master","last_synced_at":"2025-04-12T01:55:01.400Z","etag":null,"topics":["markdown"],"latest_commit_sha":null,"homepage":"http://younghz.github.io/Markdown/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/younghz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2014-04-27T14:10:38.000Z","updated_at":"2025-04-11T10:35:20.000Z","dependencies_parsed_at":"2022-07-14T04:00:32.375Z","dependency_job_id":"89e35b57-0c85-4abe-897a-f660aee07b96","html_url":"https://github.com/younghz/Markdown","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younghz%2FMarkdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younghz%2FMarkdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younghz%2FMarkdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/younghz%2FMarkdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/younghz","download_url":"https://codeload.github.com/younghz/Markdown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505869,"owners_count":21115354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown"],"created_at":"2024-09-24T20:37:31.734Z","updated_at":"2025-04-12T01:55:06.970Z","avatar_url":"https://github.com/younghz.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"## 主要内容\n\u003e #### Markdown*是什么*？\n\u003e #### *谁*创造了它？\n\u003e #### *为什么*要使用它？\n\u003e #### *怎么*使用？\n\u003e #### *谁*在用？\n\u003e #### 尝试一下\n\n## 正文\n### 1. Markdown*是什么*？\n**Markdown**是一种轻量级**标记语言**，它以纯文本形式(*易读、易写、易更改*)编写文档，并最终以HTML格式发布。    \n**Markdown**也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。    \n\n### 2. *谁*创造了它？\n它由[**Aaron Swartz**](http://www.aaronsw.com/)和**John Gruber**共同设计，**Aaron Swartz**就是那位于去年（*2013年1月11日*）自杀,有着**开挂**一般人生经历的程序员。维基百科对他的[介绍](http://zh.wikipedia.org/wiki/%E4%BA%9A%E4%BC%A6%C2%B7%E6%96%AF%E6%B2%83%E8%8C%A8)是：**软件工程师、作家、政治组织者、互联网活动家、维基百科人**。    \n\n他有着足以让你跪拜的人生经历：    \n+ **14岁**参与RSS 1.0规格标准的制订。     \n+ **2004**年入读**斯坦福**，之后退学。   \n+ **2005**年创建[Infogami](http://infogami.org/)，之后与[Reddit](http://www.reddit.com/)合并成为其合伙人。   \n+ **2010**年创立求进会（Demand Progress），积极参与禁止网络盗版法案（SOPA）活动，最终该提案被撤回。   \n+ **2011**年7月19日，因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。     \n+ **2013**年1月自杀身亡。    \n\n![Aaron Swartz](https://github.com/younghz/Markdown/raw/master/resource/Aaron_Swartz.jpg)\n\n天才都有早逝的归途。\n\n### 3. *为什么*要使用它？\n+ 它是易读（看起来舒服）、易写（语法简单）、易更改**纯文本**。处处体现着**极简主义**的影子。\n+ 兼容HTML，可以转换为HTML格式发布。\n+ 跨平台使用。\n+ 越来越多的网站支持Markdown。\n+ 更方便清晰地组织你的电子邮件。（Markdown-here, Airmail）\n+ 摆脱Word（我不是认真的）。\n\n### 4. *怎么*使用？\n如果不算**扩展**，Markdown的语法绝对**简单**到让你爱不释手。\n\nMarkdown语法主要分为如下几大部分：\n**标题**，**段落**，**区块引用**，**代码区块**，**强调**，**列表**，**分割线**，**链接**，**图片**，**反斜杠 `\\`**，**符号'`'**。\n\n#### 4.1 标题\n两种形式：  \n1）使用`=`和`-`标记一级和二级标题。\n\u003e 一级标题   \n\u003e `=========`   \n\u003e 二级标题    \n\u003e `---------`\n\n效果：\n\u003e 一级标题   \n\u003e =========   \n\u003e 二级标题\n\u003e ---------  \n\n2）使用`#`，可表示1-6级标题。\n\u003e \\# 一级标题   \n\u003e \\## 二级标题   \n\u003e \\### 三级标题   \n\u003e \\#### 四级标题   \n\u003e \\##### 五级标题   \n\u003e \\###### 六级标题    \n\n效果：\n\u003e # 一级标题   \n\u003e ## 二级标题   \n\u003e ### 三级标题   \n\u003e #### 四级标题   \n\u003e ##### 五级标题   \n\u003e ###### 六级标题\n\n#### 4.2 段落\n段落的前后要有空行，所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用**两个以上**空格加上回车（引用中换行省略回车）。\n\n#### 4.3 区块引用\n在段落的每行或者只在第一行使用符号`\u003e`,还可使用多个嵌套引用，如：\n\u003e \\\u003e 区块引用  \n\u003e \\\u003e\u003e 嵌套引用  \n\n效果：\n\u003e 区块引用  \n\u003e\u003e 嵌套引用\n\n#### 4.4 代码区块\n代码区块的建立是在每行加上4个空格或者一个制表符（如同写代码一样）。如    \n普通段落：\n\nvoid main()    \n{    \n    printf(\"Hello, Markdown.\");    \n}    \n\n代码区块：\n\n    void main()\n    {\n        printf(\"Hello, Markdown.\");\n    }\n\n**注意**:需要和普通段落之间存在空行。\n\n#### 4.5 强调\n在强调内容两侧分别加上`*`或者`_`，如：\n\u003e \\*斜体\\*，\\_斜体\\_    \n\u003e \\*\\*粗体\\*\\*，\\_\\_粗体\\_\\_\n\n效果：\n\u003e *斜体*，_斜体_    \n\u003e **粗体**，__粗体__\n\n#### 4.6 列表\n使用`·`、`+`、或`-`标记无序列表，如：\n\u003e \\-（+\\*） 第一项\n\u003e \\-（+\\*） 第二项\n\u003e \\- （+\\*）第三项\n\n**注意**：标记后面最少有一个_空格_或_制表符_。若不在引用区块中，必须和前方段落之间存在空行。\n\n效果：\n\u003e + 第一项\n\u003e + 第二项\n\u003e + 第三项\n\n有序列表的标记方式是将上述的符号换成数字,并辅以`.`，如：\n\u003e 1 . 第一项   \n\u003e 2 . 第二项    \n\u003e 3 . 第三项    \n\n效果：\n\u003e 1. 第一项\n\u003e 2. 第二项\n\u003e 3. 第三项\n\n#### 4.7 分割线\n分割线最常使用就是三个或以上`*`，还可以使用`-`和`_`。\n\n#### 4.8 链接\n链接可以由两种形式生成：**行内式**和**参考式**。    \n**行内式**：\n\u003e \\[younghz的Markdown库\\]\\(https:://github.com/younghz/Markdown \"Markdown\"\\)。\n\n效果：\n\u003e [younghz的Markdown库](https:://github.com/younghz/Markdown \"Markdown\")。\n\n**参考式**：\n\u003e \\[younghz的Markdown库1\\]\\[1\\]    \n\u003e \\[younghz的Markdown库2\\]\\[2\\]    \n\u003e \\[1\\]:https:://github.com/younghz/Markdown \"Markdown\"    \n\u003e \\[2\\]:https:://github.com/younghz/Markdown \"Markdown\"    \n\n效果：\n\u003e [younghz的Markdown库1][1]    \n\u003e [younghz的Markdown库2][2]\n\n[1]: https:://github.com/younghz/Markdown \"Markdown\"\n[2]: https:://github.com/younghz/Markdown \"Markdown\"\n\n**注意**：上述的`[1]:https:://github.com/younghz/Markdown \"Markdown\"`不出现在区块中。\n\n#### 4.9 图片\n添加图片的形式和链接相似，只需在链接的基础上前方加一个`！`。\n#### 4.10 反斜杠`\\`\n相当于**反转义**作用。使符号成为普通符号。\n#### 4.11 符号'`'\n起到标记作用。如：\n\u003e\\`ctrl+a\\`\n\n效果：\n\u003e`ctrl+a`    \n\n#### 5. *谁*在用？\nMarkdown的使用者：\n+ GitHub\n+ 简书\n+ Stack Overflow\n+ Apollo\n+ Moodle\n+ Reddit\n+ 等等\n\n#### 6. 尝试一下\n+ **Chrome**下的插件诸如`stackedit`与`markdown-here`等非常方便，也不用担心平台受限。\n+ **在线**的dillinger.io评价也不错   \n+ **Windowns**下的MarkdownPad也用过，不过免费版的体验不是很好。    \n+ **Mac**下的Mou是国人贡献的，口碑很好。\n+ **Linux**下的ReText不错。    \n\n**当然，最终境界永远都是笔下是语法，心中格式化 :)。**\n\n****\n**注意**：不同的Markdown解释器或工具对相应语法（扩展语法）的解释效果不尽相同，具体可参见工具的使用说明。\n虽然有人想出面搞一个所谓的标准化的Markdown，[没想到还惹怒了健在的创始人John Gruber]\n(http://blog.codinghorror.com/standard-markdown-is-now-common-markdown/ )。\n****\n以上基本是所有traditonal markdown的语法。\n\n### 其它：\n列表的使用(非traditonal markdown)：\n\n用`|`表示表格纵向边界，表头和表内容用`-`隔开，并可用`:`进行对齐设置，两边都有`:`则表示居中，若不加`:`则默认左对齐。\n\n|代码库                              |链接                                |\n|:------------------------------------:|------------------------------------|\n|MarkDown                              |[https://github.com/younghz/Markdown](https://github.com/younghz/Markdown \"Markdown\")|\n|MarkDownCopy                              |[https://github.com/younghz/Markdown](https://github.com/younghz/Markdown \"Markdown\")|\n\n\n关于其它扩展语法可参见具体工具的使用说明。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyounghz%2Fmarkdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyounghz%2Fmarkdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyounghz%2Fmarkdown/lists"}