{"id":20580704,"url":"https://github.com/data-camp/markdown","last_synced_at":"2025-03-06T12:15:27.376Z","repository":{"id":111003440,"uuid":"123399572","full_name":"Data-Camp/Markdown","owner":"Data-Camp","description":"Mardown - 规范书写语言","archived":false,"fork":false,"pushed_at":"2018-03-05T02:32:30.000Z","size":1752,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-16T22:34:46.894Z","etag":null,"topics":["markdown","tutorial"],"latest_commit_sha":null,"homepage":"http://study.163.com/course/introduction/1005010001.htm","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Data-Camp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-01T07:36:25.000Z","updated_at":"2018-06-19T10:36:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"0966c3b9-ff26-4c4e-b97e-ae0ad1c0f931","html_url":"https://github.com/Data-Camp/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/Data-Camp%2FMarkdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Data-Camp%2FMarkdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Data-Camp%2FMarkdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Data-Camp%2FMarkdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Data-Camp","download_url":"https://codeload.github.com/Data-Camp/Markdown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242206044,"owners_count":20089255,"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","tutorial"],"created_at":"2024-11-16T06:24:58.675Z","updated_at":"2025-03-06T12:15:27.354Z","avatar_url":"https://github.com/Data-Camp.png","language":null,"readme":"# Markdown - 规范书写语言\n\n**Markdown语言简介**\n=======\n\u003e **请点击右上角编辑按钮查看原文**\n\n## Markdown语言简介\n\nMarkdown语法的目标是：成为一种适用于网络的书写语言。特性是「易读易书写」。Markdown是一种书写语言，是大家约定好的一种书写有结构的文本文件的方式。而HTML，pdf是发布的格式。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。\n\nMarkdown的设计目标是容易转化成HTML发布。所有在Markdown中的标记实际都被MD编辑器转化成HTML元素了。Markdown实质是简化易读易写的HTML书写语言，解释成HTML。MD和HTML是完全兼容的，可以在MD中加入HTML的标签。\n\nMarkdown有许多衍生版本，GitHub Flavored Markdown（GFM）是GitHub的一个MD语言扩展，对程序员来说很有爱。GFM部分的有爱特性：（1）代码高亮（2）任务列表（3）自动URL链接。\n\n## 为什么要写解释性文本？\n\n可读性。写报告是给别人（机器）看的，不能默认别人和你一样了解你的思路，所以你有义务引导别人更好的理解你的思路。另外，自己也可以忘记之前的思路，所以需要记录方便回忆。\n\n可以看到，可读性是解释性文本的精髓，为了实现可读性，就要求我们保持文本的美观性和指代清晰。Markdown语言正是带着这样的初衷提出的，所以Jupyter在这里选用了Markdown来作为官方的解释性文本编辑语言。\n\nMarkdown通过如下设计来实现美观性和指代清晰：\n美观性：表格的自动排版，空行缩进的自动控制，超链接的准确定义等，数学公式 (配合Latex)\n指代清晰：标题的精准分类调用，加粗斜体的精准调用等\n\n对比直接使用Word进行最合乎直觉的文本编辑，使用Markdown在早期有一个简单的学习曲线，主要是学习各种格式的引用方法。一旦入门，您将逐步感受到Markdown语言的准确性和美观性给文本编辑带来的便捷。\n\n## Markdown语法范例：\n\n标题\n# 一级标题\n1. 加粗/斜体\n\n\t**数据分析** 加粗；*机器学习* 斜体；*You **can** combine them*\n2. 转义字符 (Backslash Escapes)\n\n\t\\*Who am I\\*\n3. 有序标签/无序标签\n   * 项目一\n   1. 项目二\n4. 超链接\n[GitHub](http://github.com)\n5. 图片\n\t![GitHub Logo](https://tse4-mm.cn.bing.net/th?id=OIP.3aMGy-X3Qd1B3ek2dsipDAHaHa\u0026p=0\u0026o=5\u0026pid=1.1)\n6. 代码块\n  GFM: 英文键盘数字1左边键输入\\`\n```python\nprint (2)\n```\n7. 引用\n\t\u003e Machine Learning\n\t\u003e Deep Learning\n\n## 参考\n1. [简书：献给写作者的 Markdown 新手指南](https://www.jianshu.com/p/q81RER)\n2. [GitHub: Mastering Markdown](https://guides.github.com/features/mastering-markdown/)\n3. [Wikipedia：转义字符](https://zh.wikipedia.org/wiki/%E8%BD%AC%E4%B9%89%E5%AD%97%E7%AC%A6)\n4. [StackEdit：最棒的在线Markdown编辑器](https://stackedit.io/app)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdata-camp%2Fmarkdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdata-camp%2Fmarkdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdata-camp%2Fmarkdown/lists"}