显示标签为“markdown”的博文。显示所有博文
显示标签为“markdown”的博文。显示所有博文

2020-04-08

Atom-markdown


# 1 Atom markdown
## 1.1  markdown-preview
https://atom.io/packages/markdown-preview
Markdown预览
- Edit \ preferences \ Packages \ markdown-preview
  - 默认已打开的
- Packages \ Markdown Preview \ Toggle Github Style
  - 切换为Github风格
- Edit \ Stylesheet...
  - 编辑styles.less样式表

> .markdown-preview.markdown-preview {
>   background-color: #fff;
> }
- markdown-preview 页面 右键单击预览的任何空白区域
  - 单击“Save As HTML” ...获得html文件。

## 1.2  增强预览(markdown-preview-plus)

https://atom.io/packages/markdown-preview-plus
https://github.com/atom-community/markdown-preview-plus/blob/master/docs/installation.md
- Edit \ preferences \ Install \ 搜索: markdown preview plus
  - Install 安装插件
- Edit \ preferences \ Packages \ markdown-preview
  - Atom已自动关闭了markdown-preview,若没有,可以在这里手动关闭

Atom自带的Markdown预览插件markdown-preview功能比较简单,markdown-preview-plus对其做了功能扩展和增强。
1. 支持预览实时渲染。(Ctrl + Shift + M)
2. 支持Latex公式。(Ctrl + Shift + X)
3. (可选)在引用支持下使用pandoc(通用文档转换器)

https://pandoc.org/
> $ sudo pacman -S pandoc

(← = conversion from; → = conversion to; ↔︎ = conversion from and to)
- Word processor formats
  - ↔︎ Microsoft Word docx
  - ↔︎ OpenOffice/LibreOffice ODT
  - → OpenDocument XML
  - → Microsoft PowerPoint
- HTML formats
  - ↔︎ (X)HTML 4
  - ↔︎ HTML5
- Ebooks
  - ↔︎ EPUB version 2 or 3
  - ↔︎ FictionBook2
- Data formats
  - ← CSV tables
- PDF
  - → via pdflatex, xelatex, lualatex, pdfroff, wkhtml2pdf, prince, or weasyprint.
- Lightweight markup formats
  - ↔︎ Markdown (including CommonMark and GitHub-flavored Markdown)
  - ... 还有更多,请参阅官网

# 2 更多软件包
1. 同步滚动(markdown-scroll-sync)
   - https://atom.io/packages/markdown-scroll-sync
2. 代码增强(language-markdown)
   - https://atom.io/packages/language-markdown
   - 添加了对Markdown的语法支持(including Github flavored, AtomDoc, Markdown Extra, CriticMark, YAML/TOML front-matter, and R Markdown),以及列表中的智能上下文感知行为和内联重点的键盘快捷键。
3. 图片粘贴(markdown-image-paste)
   - https://atom.io/packages/markdown-image-paste
   1. 截图或复制图片到系统剪切板。
   2. 在Markdown新起一行输入文件名。
   3. 点击ctrl + v将图像粘贴到markdown或rst文件中
      - 默认保存到Markdown文件相同目录下(因此要求Markdown文件应该先保存)。
      - (如果找不到图片),从新输入文件名,英文的无空格文本
4. 表格编辑(markdown-table-editor)
   - https://atom.io/packages/markdown-table-editor
   - ![markdown-table-editor](https://i.github-camo.com/c2a810dc038c3fb1a3d3373fc6ae83c51112997f/68747470733a2f2f6769746875622e636f6d2f7375736973752f6d61726b646f776e2d7461626c652d656469746f722f77696b692f696d616765732f64656d6f2e676966)

      | Name          | Description               | Keybinding  |
      | ------------- | ------------------------- | ----------- |
      | Next Cell     | Move to the next Cell     | tab         |
      | Previous Cell | Move to the previous cell | shift + tab |
      | Next Row      | Move to the next row      | enter       |
      | Escape        | Escape from table         | ESC         |


5. pdf导出(markdown-themeable-pdf、pdf-view), 比上面的pandoc轻便些,可以试试。
6. 格式化JSON(pretty-json)
   - https://atom.io/packages/pretty-json
   - ![pretty-json](https://i.github-camo.com/df2969f63f4141f94d94d6f5ab71b3a4266811b5/687474703a2f2f692e696d6775722e636f6d2f4e6434477674502e676966)

7. 格式化(atom-beautify)
   - https://atom.io/packages/atom-beautify
   - Beautify HTML, CSS, JavaScript, PHP, Python, Ruby, Java, C, C++, C#, Objective-C, CoffeeScript, TypeScript, Coldfusion, SQL, and more in Atom
8. 更多软件包,可以在官网查看,首页有[当天/本周/本月]最受欢迎的排行,看看有没有你需要的。
   - https://atom.io/packages
- markdown-preview-enhanced.语法高亮,双向实时预览。(推荐)
   - https://atom.io/packages/markdown-preview-enhanced
- markdown-toc,markdown目录生成插件
   - https://atom.io/packages/markdown-toc
- markdown-writer,markdown编辑器插件
   - https://atom.io/packages/markdown-writer
- apm install file-icons 图标
   - https://atom.io/packages/file-icons

# 3 参考阅读
如何设置和使用Atom作为Markdown编辑器
https://www.portent.com/blog/copywriting/content-strategy/atom-markdown.htm

使用Atom打造无懈可击的Markdown编辑器
https://www.cnblogs.com/fanzhidongyzby/p/6637084.html

2020-04-01

Markdown

# 1. Markdown {1}

https://en.wikipedia.org/wiki/Markdown
https://zh.wikipedia.org/wiki/Markdown
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。

# 2. 标准化 {2}

## 2.1 CommonMark {2.1}

从2012年开始,包括Jeff Atwood和John MacFarlane在内的一群人启动了标准化工作, 更名为CommonMark. http://spec.commonmark.org/

## 2.2 GFM {2.2}

2017年,GitHub发布了基于CommonMark的GitHub Flavored Markdown(GFM)的正式规范。除了表格、删除线、自动链接和任务列表被GitHub规范作为扩展添加之外,它遵循CommonMark规范。GitHub还相应地更改了其站点上使用的解析器,这要求更改某些文档 - 例如,GFM现在要求创建标题的哈希符号由空格字符分隔。
- https://github.github.com/gfm/
- https://help.github.com/en/github/writing-on-github
- https://help.github.com/cn/github/writing-on-github

## 2.3 Markdown Extra {2.3}

Markdown Extra是一种轻量级标记语言,基于在PHP(最初),Python和Ruby中实现的Markdown。它添加了普通Markdown语法不具备的功能。
内容管理系统支持Markdown Extra,例如Drupal, TYPO3, MediaWiki。
它为Markdown添加了以下功能: HTML块内的markdown标记; 具有id / class属性的元素; 围栏代码块; 表格; 定义清单; 脚注; 缩写;

# 3. Markdown使用 {3}
## 3.1 Markdown 入门 {3.1}
https://markdown.bootcss.com/getting-started/
Markdown 语法的首要设计目标是尽可能易读。基于这个目标,Markdown 格式的文档能够以纯文本形式原样发布,而不会看起来像被填满了标签或格式化指令。

## 3.2 Markdown语法 {3.2}
[Markdown 速查表](https://markdown.bootcss.com/cheat-sheet/)
Markdown 速查表提供了所有 Markdown 语法元素的快速参考。但是此速查表无法覆盖所有用法,因此,如果你需要某些语法元素的更多信息,请参阅我们的: [基本语法](https://markdown.bootcss.com/basic-syntax/); [扩展语法](https://markdown.bootcss.com/extended-syntax/)

## 3.3 推荐的一些Markdown文档创作应用程序: {3.3}
https://markdown.bootcss.com/getting-started/#documents
- Mac: MacDown, iA Writer, or Marked
- iOS / Android: iA Writer
- Windows: ghostwriter or Markdown Monster
- Linux: ReText or ghostwriter
 - https://wiki.archlinux.org/index.php/List_of_applications/Documents#Markdown
 - https://wiki.gentoo.org/wiki/ReText
 - https://github.com/retext-project/retext
- Web: Dillinger or StackEdit
 - https://dillinger.io/
 - https://markdown.bootcss.com/tools/stackedit/

## 3.4 Markdown 相关工具 {3.4}
https://markdown.bootcss.com/tools/
支持 Markdown 的应用程序和组件。下表
 | name | 中文描述 | 英文描述 |
 | :-----------: | :----------- | :----------- |
 | Bear | Bear是适用于macOS和iOS设备的Markdown笔记应用程序。 | Bear is a Markdown notes application for macOS and iOS devices. |
name中文描述英文描述
BearBear是适用于macOS和iOS设备的Markdown笔记应用程序。Bear is a Markdown notes application for macOS and iOS devices.
BoostnoteBoostnote是面向开发人员的Markdown笔记应用程序。Boostnote is a Markdown note taking application for developers.
CodiMDCodiMD是一个开源的实时协作Markdown编辑器。CodiMD is an open-source real-time collaborative Markdown editor.
DillingerDillinger是专为移动写作而设计的在线Markdown编辑器。Dillinger is an online Markdown editor designed for on-the-go writing.
DocusaurusDocusaurus将Markdown文件转换为文档网站。Docusaurus converts Markdown files to a documentation website.
GhostGhost是一个开源CMS,以其速度,简单性和易用性而闻名。Ghost is an open source CMS renowned for its speed, simplicity, and ease of use.
GitBookGitBook是文档网站和知识库的托管解决方案。GitBook is a hosted solution for documentation websites and knowledge bases.
GitHub PagesGitHub Pages是一项免费服务,可将Markdown文件转换为网站。GitHub Pages is a free service that turns Markdown files into a website.
HugoHugo是一个静态网站生成器,可将Markdown文件转换为网站。Hugo is a static site generator that converts Markdown files to a website.
iA WriteriA Writer是最著名的Markdown编辑器之一。iA Writer is one of the most established and widely-acclaimed Markdown editors.
ImdoneImdone是基于markdown的看板,位于注释,文档和代码中。Imdone is a markdown based kanban board, that lives in your notes, docs, and code.
JekyllJekyll是一个静态网站生成器,可将Markdown文件转换为网站。Jekyll is a static site generator that converts Markdown files to a website.
Joplin乔普林(Joplin)是一个记笔记应用程序,它尊重您的隐私。Joplin is a note taking application that respects your privacy.
MacDownMacDown是可用于macOS的最佳Markdown编辑器之一。MacDown is one of the best Markdown editors available for macOS.
Mark TextMark Text是专为Markdown设计的流行的免费开放源代码编辑器。Mark Text is a popular free and open-source editor designed for Markdown.
MarkdeepMarkdeep会将任何Markdown文件转换为独立的HTML文件。Markdeep turns any Markdown file into a self-contained HTML file.
Markdown HereMarkdown这是一个浏览器扩展程序,可以转换Web表单中的Markdown文本。Markdown Here is a browser extension that converts Markdown text in web forms.
MattermostMattermost是一个开源消息传递和团队协作应用程序。Mattermost is an open source messaging and team collaboration application.
MkDocsMkDocs是用于构建文档网站的静态网站生成器。MkDocs is a static site generator for building documentation websites.
Notable值得注意的是带有Markdown支持的准系统笔记应用程序。Notable is a bare-bones note taking application with great Markdown support.
Notion概念是针对所有人的多合一知识管理解决方案。Notion is an all-in-one knowledge management solution for everyone.
RedditReddit是一个受欢迎的在线社区,支持在Markdown中发布。Reddit is a popular online community that supports posting in Markdown.
SimplenoteSimplenote是跨平台的Markdown笔记应用程序。Simplenote is a cross-platform Markdown notes application.
SlackSlack是一个消息传递和团队协作应用程序。Slack is a messaging and team collaboration application.
SquarespaceSquarespace是用于构建网站的流行订阅服务。Squarespace is a popular subscription service for building websites.
StackEditStackEdit是功能强大的在线Markdown编辑器,您可以在任何地方使用。StackEdit is a powerful online Markdown editor you can use anywhere.
Standard NotesStandard Notes是一种优雅的开源笔记记录应用程序。Standard Notes is an elegant, open-source note taking application.
TrelloTrello是一个看板风格的项目管理应用程序。Trello is a kanban-style project management application.
TyporaTypora是一种用于便笺和文档的简单且可配置的编辑器。Typora is a simple and configurable editor designed for notes and documents.
UlyssesUlysses是适用于macOS和iOS设备的流行编写应用程序。Ulysses is a popular writing application for macOS and iOS devices.

## 3.5 Markdown 更多教程 {3.5}
https://www.runoob.com/markdown/md-tutorial.html
本教程将使用 Typora 编辑器来讲解 Markdown 的语法,Typora 支持 MacOS 、Windows、Linux 平台,且包含多种主题,编辑后直接渲染出效果。
支持导出HTML、PDF、Word、图片等多种类型文件。
Typora 官网:https://typora.io/
你也可以使用我们的在线编辑器来测试: https://c.runoob.com/front-end/712

https://www.markdownguide.org/
https://github.com/showdownjs/showdown
http://demo.showdownjs.com/

## 3.6 cnblogs支持markdown {3.6}
https://www.cnblogs.com/cmt/p/markdown.html
更新:2014年7月22日发布了新版markdown功能,详见新版markdown功能发布!支持github flavored markdown!
https://www.cnblogs.com/cmt/p/markdown_github.html
markdown语法:Markdown Cheatsheet
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

## 3.7 小结 {3.7}
Markdown相对html等标记语言,确是简洁,但简单了解下来也仅适合书写简单的介绍,没有表格,目录的短文。
扩展语法里有表格,也可以这是左右对齐等;也有标题的ids,但是使用起来反而不如html方便啊。
对这种轻量级的语言也仅适合轻量级的应用。github使用pages页面,就是个介绍页面。
在没有表格,不需要目录的情况下,还是很方便的。Linux下很多图形化的文档编辑器都支持md格式,就是说默认情况下保存问*.md文件,就能在写文档的同时清晰的看到标题,列表等,使用默认的颜色区分来开。

# 4. See Also {4}
选择正确的Markdown解析器
https://css-tricks.com/choosing-right-markdown-parser/
如果您要选择要使用的版本(或您要在网络产品上提供给用户的版本),则必须了解要使用的版本,因为一旦选择并有内容就很难切换那里取决于那些功能。
https://github.com/markdown/markdown.github.com/wiki/Implementations

What are the main rendering differences between Markdown and CommonMark?
https://help.apiary.io/faq/commonmark/

https://en.wikipedia.org/wiki/List_of_document_markup_languages
https://zh.wikipedia.org/wiki/文档标记语言比较
https://en.wikipedia.org/wiki/Comparison_of_document-markup_languages
https://en.wikipedia.org/wiki/Lightweight_markup_language
https://en.wikipedia.org/wiki/Lightweight_markup_language#Comparison_of_lightweight_markup_language_syntax
https://en.wikipedia.org/wiki/Lightweight_programming_language
https://en.wikipedia.org/wiki/Lightweight_software
https://en.wikipedia.org/wiki/Wiki_markup
https://en.wikipedia.org/wiki/Help:Wikitext

https://sspai.com/post/55786
个人博客的方案推荐,你只负责编写
docsify 是一个动态生成文档网站的工具。不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件,所有转换工作都是在运行时进行。这将非常实用,如果只是需要快速的搭建一个小型的文档网站,或者不想因为生成的一堆 .html 文件「污染」commit 记录,只需要创建一个 index.html 就可以开始写文档而且直接部署在 GitHub Pages。
https://docsify.js.org/#/zh-cn/themes
https://cdn.jsdelivr.net/npm/docsify/lib/themes/dark.css

10分钟让你的站点也支持Markdown
https://blog.csdn.net/github_36700243/article/details/62430414
https://github.com/showdownjs/showdown

AC-power

导航 (返回顶部) 1. AC 1.1 Alternating current 1.2 简谐交流电 1.3 频率 1.4 峰值和有效值 2. 交流电相位分类 2.1 单相电 2.2 三相电 2.3 比较 2.4 220v交流电的3个电压值 2.5 相电压与...