为什么要提图片管理？本站日常的文件编辑都是基于markdown，使用的编辑器是typora，我自己是买了license，可能测试版本也包含我今天这篇文章的东西。每次写文章都会有相关的图片插入，网站的图片我都是存在腾讯的oss里面，这样的做法式考虑将静态的东西与网站运行隔离，同时又可以减少存储，其实存储也占不了多少哈，还有个好处就是加快访问速度。怎么做？先说说我一开始是怎么管理图片的。我电脑上是安装了upic客户端在里面配置好腾讯云oss，就可以直接将相应的文件传递到对应的存储桶里，然后我在找到相应的链接复制粘贴到markdown文件中，这个在图片少的时候操作还ok，图片一多操作还是很麻烦的。前几天我在修改图片的时候，我选中图片的时候发现有一个上传图片的按钮，然后点进去看了下typora其实是有专门的图像管理配置，估计我现在碰到的问题是一个大家都会遇到的，有个专门的解决方案。上图那个插入图片时是一个触发机制，当你在文件里插入一个图时就会触发上传图片的操作。那么图片上传到哪？这就是下面上传服务设定的配置了，我是本地安装了upic，然后在配置的选项中有upic，选择之后点击验证图片上传选项，这样的话验证通过就可以实现图片插入时自动上传了。我在写这篇文章的时候就已经是这样的效果，实在是方便的很！结语有空多折腾，说不定有新的发现，后续有机会在分享编辑器typora其他技巧 ...继续阅读 (62)

复杂项目的运营中，文档站点通常不可或缺，比如我正在开发维护的WonderPen软件，虽然我一直努力让各个功能都尽可能简明易懂，但当软件的功能复杂到一定程度之后，用户对文档的需求仍然与日俱增，因为总有一些功能难以做到一看就明白，同时也总有一些功能的入口不会直接显示在主界面，如果没有说明，用户可能要花很长时间才能发现。为了构建文档站点，我尝试过很多方案，最后选择了基于 Next.js 自建，本文记录了一些相关经历。需求文档站点主要用于存放产品的使用和帮助说明，内容一般是纯静态的，可以没有用户留言、评论等模块，从功能角度来讲比较简单。对文档站点，我的需求主要有以下几点：最好能使用 Markdown 写文档；支持多语言（暂时只有中文、英文的需求）；能深度定制样式；能提前批量修改或新建文档，然后再在指定的时间统一发布更新。其中第一、二、三点无需多说，关于第四点“批量修改、统一发布”，应该是软件或类似分版本发布的产品共同的需求。举个例子，软件的下一个版本可能有很多变化，文档也需要做对应的变更，比如修改相关的功能说明（也许涉及几个至几十个页面），更新对应的界面截图等等，并且需要在新版发布时同步更新上线。对这样的需求，使用语雀等在线知识库就不是很合适，虽然它们的功能很强大，但发布粒度是基于单个文档的，很难实现批量修改多个文档，并在指定时间统一发布。目前，要实现这个需求，基本上需要使用专门的文档站点 ...继续阅读 (59)

Tech技术方面今年依旧学习了很多新的内容。首先从 0 到 1 使用 Next.js 重构了此 lawrenceli.me 的整个站点。由原先基于 Notion 私有 REST API 的 hacking 方式换成基于纯 Markdown 文本的 SSG（静态页面生成）和 ISR （增量静态再生成）并完成了几乎没有太多压力的Next.js 13 升级。所有文章内容均和代码共存，这样能在所有页面上自由发挥，甚至可以在纯 Markdown 文件中直接使用 React/JSX 组件（基于 HTML 抽象语法树 - AST）。依赖的版本也基于 GitHub 自动的 PR 保持了最新。 React/JSX 写的也比去年熟练多了。 另外简单研究了一下 TailWind CSS，上手很快，也在此站点上用上了。Node.js 模版项目完工，一个快速使用 JavaScript 开发 REST API 的脚手架项目，各种测试、CI/CD、Code Coverage、日志、Open API (Swagger)、JWT 等基础设施都加上了。摒弃了古老的 CommonJS 而基于纯 ES Module。WebSocket Cluster项目在 GitHub 上也快到达 100 stars 了，每周都会看到一两个国人参考我那很久没维护但精妙绝伦的代码。年底 Spring 6 和Spring Boot 3 的 ...继续阅读 (33)

1. 前言请允许我先啰嗦一下：之前很少把工作的溯源笔记和排查笔记发出来，直接原因是：上报分析报告基本都是 word 或者 pdf，没有markdown格式，整理成markdown格式浪费时间，还不如去学习新知识，或者........ ...继续阅读 (13)

...继续阅读 (18)

Moeditor是一款开源免费的全能（all-purpose）MarkDown 编辑器，支持 Windows、macOS、Linux，理所应当基于 Electron，支持双栏、数学公式、代码高亮、聚焦模式等，唯一的问题是开发者已经在 2018 年弃坑，更是在上个月将源代码存档，宣告项目的终结。@Appinn但为何又出现在了发现频道？@blythe110 同学在发现频道推荐了这个：推荐一个简洁的MarkDown编辑器本来以前一直使用的 #typora，结果现在收费了，不仅收费了，结果还连老版本都被强制不准使用了，另一个喜欢用的软件 Markdownplus 则是已经停更许久，各种小 bug不 断，导致我不得不找好用的markdown编辑软件，最终发现了这个。Moeditor 的主要的优点，也是我喜欢的地方有以下一些：免费开源；可以离线使用、编辑；可以编辑和渲染同步滚动，左边是编辑页面，右边实时渲染效果；支持 TeX math 公式和 UML diagram图表，支持引用本地图片；其他一些花里胡哨功能，比如具备专注模式、可以自定义css渲染、少量主题；支持中文界面；支持多平台，Win、Mac、Linux 通吃！可以直接导出PDF和HTML文件，相当方便。界面风格极简缺点是：确实好久都没更新了，看起来好像还是 2016 年的更新？因为是离线软件，所以没有任何的同步机制，如需进行同步之类的 ...继续阅读 (52)

最近发现越来越多的人使用Obsidian，在 1.0 正式发布以后，原生主题也更好看了；对于 Obsidian 的定位是建立和完善自己的知识库。今天主要是结合近期回答别人的一些问题做下汇总，即：使用 Obsidian 的 3 个原则。说明：我的原则不局限于 Obsidian，也适用于其他笔记软件；若其中的观点与你现在的流程（想法）有些冲突，仅供参考；3 个原则标准化什么是标准呢？比如常见的国标； 我对标准化的定义是：尽可能用普通规则做事。举个例子：印象笔记里笔记导出后是 enex 格式，这种格式只能在印象笔记中打开使用，若印象笔记跑路（概率不低）了，你的笔记就难以被打开了；若我用记事本写笔记，其笔记格式是 txt ，我用 Word 都能打开；对比来看，txt 是最普通的规则了，适配性很高，不受限于产品本身的生死存亡。Obsidian 是基于 Markdown 格式的，而 Markdown 是较为普通的一种格式，哪怕 Obsidian 黄了，我也可以其他 Markdown 工具打开，甚至可以用记事本打开，因为 Markdown 也是一种 txt 格式的文件。但是在 Obsidian 中有一些扩展的语法，可能是 Obsidian 自带，也可能是插件生成的，我自己很少用。比如块引用，使用后文中会出现 [[filename#^dcf64c]] 的内容，filename是文件名，dcf64 ...继续阅读 (30)

An h1 headerParagraphs are separated by a blank line.2nd paragraph.Italic,bold, andmonospace. Itemized lists look like:this onethat onethe other oneNote that --- not considering the asterisk --- the actual text content starts at 4-columns in.Block quotes are written like so.They can span multiple paragraphs, if you like.Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all in chapters 12--14"). Three dots ... will be converted to an ellipsis. Unicode is supported. ☺An h2 headerHere's a numbered list:first itemsecond itemthird itemNote again how the actual text starts at 4 column ...继续阅读 (7)

R的极客理想系列文章，涵盖了R的思想，使用，工具，创新等的一系列要点，以我个人的学习和体验去诠释R的强大。 R语言作为统计学一门语言，一直在小众领域闪耀着光芒。直到大数据的爆发，R语言变成了一门炙手可热的数据分析的利器。随着越来越多的工程背景的人的加入，R语言的社区在迅速扩大成长。现在已不仅仅是统计领域，教育，银行，电商，互联网….都在使用R语言。 要成为有理想的极客，我们不能停留在语法上，要掌握牢固的数学，概率，统计知识，同时还要有创新精神，把R语言发挥到各个领域。让我们一起动起来吧，开始R的极客理想。 关于作者： 张丹，分析师/程序员/Quant: R,Java,Nodejs blog: http://blog.fens.me email: bsspirit@gmail.com 转载请注明出处： http://blog.fens.me/r-markdown-rmarkdown/ 前言 Markdown格式文档编写，已经从小众成为了一种主流的文档编写方式。R语言社区在可重复性文档编写领域中，有着重要的贡献。knitr和rmarkdown等包的支持，到后来在RStudio中直接集成的rmarkdown的功能，让R的广大用户有了非常舒服的markdown文档使用体验。 2015时，我就已经开始用markdown来写书稿，当时写了2篇关于在nodejs领域中使用markdown的文章， ...继续阅读 (46)

使用方式本站源码完全公开：GitHub - la3rence/site.直接将 Markdown 文件 (.md) 存放在posts文件夹下即可渲染当前文件，使之成为静态页面(SSG)。 博客的首页索引目录也为同步生成，而无需手动维护。About页面也同理基于readme.md文件生成而来。博客相关的信息配置，如标题、作者等可在lib/config.mjs文件中配置。推荐使用pnpm来作为 node.js 的依赖管理工具。pnpm install pnpm dev本地访问http://localhost:3000即可。通过pnpm build来打包，pnpm start则用于生产环境的启动。 通过pnpm fmt来将所有代码和文本进行格式化。技术细节此站点由Next.js框架和TailwindCSS样式构成。前者是一项基于 React 的 SSG/SSR 开源项目，后者是一个目前流行的原子化 CSS 库，让不太会写 CSS、基础薄弱的我也能快速的写出灵活的样式。Next.js 会主动调用我们写好的一些函数 (getStaticProps())，让组件得到数据的输入，从而在构建阶段将 React 组件提前渲染完成。remark库可以将原生的 markdown 语法编译成 html 对应的 dom - 在此项目中，我们让它固定遍历posts文件夹下的 markdown 文件，依次编译， ...继续阅读 (36)

最近编写文档或者写博客，喜欢用 Typora 编辑器通过 Markdown 语法完成编写所有内容。为此，还付费购买了许可证。 喜欢 Typora 的理由： 所见即所得的编辑，Markdown 的语法都支持快捷键操作，非常方便 可以自定义主题的 CSS，包括文章内容就可以粘贴到公众号里 上传图片，支持图床服务。可以将图片上传到指定的图床，前提是需要先安装一个客户端，这里我使用的是 PicGo。然 … ...继续阅读 (39)

话说「Notion」的 Block 模块化编辑真的是引领了笔记软件“变革”的风潮，如今笔记软件也在不断进化，诸如Markdown支持、双向链接等先进的新特性也越来越受到重视。但考虑到网络问题、数据隐私和安全性，很多人都无法放心将所有笔记保存在 Notion、Wolai 这类纯在线服务上，一旦服务变卦 (比如收费、倒闭等) 都会很被动。所以，如果有一款既拥有各种先进特性，还能自建服务器的开源笔记软件，那就非常完美了！而它就是思源笔记……「前往查看原文....」异次元还有这些值得一看：代替 Notion 中国版？！印象笔记推出新一代「超级笔记」模块化编辑器Notion - “杀手级”出色的全能型笔记软件 (替代印象笔记/强大灵活/支持Markdown)印象笔记 (Evernote中国版) - 最佳笔记软件知识管理工具应用 / 资料收集整理MWeb 4 Pro - 行云流水的一体式 Markdown 编辑器/写作/笔记/静态博客网站生成工具异次元正版数字商城 | 异次元首页 | 微信公众号 | iPcFun | 关注微博 | 软件精选 ...继续阅读 (50)

...继续阅读 (73)

1 本文概览 2 本文背景 3 软件配置 3.1 安装 R 包 3.2 安装 TinyTeX 3.3 安装字体 3.4 安装主题 3.5 其他配置 4 制作 beamer 幻灯片 4.1 LaTeX 4.2 Pandoc’s Markdown 4.2.1 简单示例 4.2.2 LaTeX 模版 4.2.3 幻灯 ...继续阅读 (28)

微软近日发布官方博客表示，他们经过半年时间的努力为 VS Code 带来了 Markdown 语言服务器（Markdown Language Server），团队认为 Markdown 语言服务器是可以推动 VS ...继续阅读 (61)

Just copy the embed code from YouTube or other platforms, and paste it in the markdown file.--- title: Include Video in the Post published: 2023-10-19 // ... ---YouTubeBilibili ...继续阅读 (7)

TheHTML element represents small annotations that are rendered above, below, or next to base text, usually used for showing the pronunciation of Japanese and Chinese characters. There is amarkup syntax discussionin the CommonMark Discussion, among which, I prefer thesyntax designed by JuanitoFatas.[漢字(かんじ)] [漢字(かんじ)](https://jisho.org/search/漢字)The benefits are obvious:The markup looks pretty and easy to understandIt works well together with linksHowever, the syntax for separated ruby annotations is a little complex:[[漢(かん)][字(じ)]](https://jisho.org/search/漢字)While inmistunev3, I've added a ru ...继续阅读 (21)

kg-card-begin: markdown感想人往往想出于自我保护般的不想改变，不想踏出舒适圈在很多时候，恐惧和犹豫会让我停滞不前，然后我的内心就开始纠结，开始找各种理由来骗自己：我做不到，因为我太忙了，因为时机还不到，因为我还没找到感觉……但我同时也会问自己：做这件事会让我成长吗？如果这个选择能让我成长，那我就倾向于选择去做。感觉应该是要用正确的角度思考问题，不能只以我这个角度出发？问自己正确的问题。好的问题，能改变你看待一件事的视角，从而让正确的选项显现出来。良好的社交圈子丰富自己的见闻，旅行是个不错的选择财富自由圆满的家庭我的人生目标：·深切地关怀，充满乐趣地与世界连接，强烈地热爱，慷慨地分享；·愉悦地探索、学习、成长并取得成就；·创造性、聪明且高尚地为这个世界整体的美好做出贡献。现在很缺乏，来这边十几年了，没有什么朋友社交现在就处于这个状态之下，每天有做不完的事 没有自己的生活，没有目标，我不愿让自己每天紧张兮兮，疯狂工作，牺牲健康，也许可以体验一下多相睡眠我也有这种沉浸感，但是这是不是人们说的三分钟热度？坚持下去才算是成功吧！。我喜欢让自己沉浸在各种体验中，有些只是短期的，而有些则会成为长期的生活方式转变。kg-card-end: markdown划线多相睡眠社交总是倾向于拥抱新事物，而不是反复做那些已经完成的事情。 ...继续阅读 (49)

【摘要】概述 Mermaid（美人鱼）是一套markdown语法规范，用来在markdown文档中定义图形，包括流程图、序列图、甘特图等等。 它的官方网站是 https://mermaid-js.github.io/mermaid/#/ 另外有一个在线的测试网站 https://mermaid.live 强阅读全文 ...继续阅读 (47)

GitHub的Markdown目前不支持直接[TOC]渲染文章的目录，有些README则需要这样的效果，可以借助外部工具进行生成，也可以借助 GitHub Actions 自动生成，本文就介绍这种方式。 ...继续阅读 (14)

GitHub Repository CardsYou can add dynamic cards that link to GitHub repositories, on page load, the repository information is pulled from the GitHub API.::github{repo="Fabrizz/MMM-OnSpotify"}Create a GitHub repository card with the code::github{repo="/"}.::github{repo="saicaca/fuwari"}AdmonitionsFollowing types of admonitions are supported:notetipimportantwarningcaution:::note Highlights information that users should take into account, even when skimming. ::::::tip Optional information to help a user be more successful. ::::::important Crucial information necessary for users to succeed. ::::: ...继续阅读 (9)

受年龄增长以及生活影响，人接触到的新事物和知识将会越来越多，大脑就显得有些混乱了，我也不敢保证自己的思维会始终保持一个高强度的在线状态。 因此决定整理个人知识库，将大脑中的片段和思想整理出来。以笔记和文字的形式将他记录下来，但是最近一直在寻求这样的工具，多方对比，也没有一款能真正满足我的需求的工具。 最好是自建的笔记，因为我今天在语雀写了一篇私密笔记，或许因为内容略带敏感吧，然后就被审查了，说我违规。 语雀这是我目前最满意的工具，但是现在对他的热情瞬间降低了很多。我怕哪天一下子账号里面的笔记全部被删了，那样我会很绝望的。 接下来我还会多方对比，最终选择一款平台亦或者是自建的笔记系统。 博客是写给别人看的，笔记是给自己看的，包括一些计划，列表清单等等，都是隐私的内容。还有就是一些文章的草稿，碎片化的记录，所以不宜放在博客上。 而且对于功能方面，我也有较高的要求，比如拖拽，表单，下拉框，卡片等等，都是我比较需要的，隐私和安全性更是我比较看重的。 暂时就这样吧，我会慢慢寻觅。 2022/05/03 更新 经过为期一周的尝试和部署过后，我最终决定了使用思源笔记，可以使用 docker 进行私有部署，本地备份，而且还可以选择付费订阅，备份到官方，这是两种可以同时进行的选择，我觉得很好的满足了我的需要。 主要还是思源的功能以及外表打动了我，页面简洁而美，功能不臃肿，刚好我需要的他都有，一点也没 ...继续阅读 (13)

uniapp 开发小程序，有几段文字涉及到经常要修改，考虑再三决定markdown文件放服务器，测试同事可以随时修改，然后后台读取markdown内容，然后给前台传字符串，然后前台将字符串渲染，在uniapp插件管理找插件，首先找到了用的人最多的u.parse富文本来渲染，但是由于要渲染mark down所以要用到marked.js，因为项目已经有了components文件也有wxcomponents不想有太多的文件来放插件，所以没有通过npm install安装marked，按照插件文档一直报错，于是乎换插件 ：jo- markdown结果很神奇，插件的demo跑起来没问题，在项目里就渲染失败；于是乎在大神的帮助下又开始研究marked，再次更改插件以后引用了该插件的marked.js在u.parse里面。结果，神奇的事情发生了，渲染成功，仔细研究最后发现虽然两个文件都写的是marked的官网，但是他们里面的方法却做了改u.parse：调用marked.min.js，需要将marked(`ddd),修改为marked.parse(``);如果高光markdown调用要用marked(`xx`) uniapp渲染markdown遇到的坑最先出现在蒋丽君的小站。 ...继续阅读 (12)

uniapp 开发小程序，有几段文字涉及到经常要修改，考虑再三决定markdown文件放服务器，测试同事可以随时修改，然后后台读取markdown内容，然后给前台传字符串，然后前台将字符串渲染，在uniapp插件管理找插件，首先找到了用的人最多的u.parse富文本来渲染，但是由于要渲染mark down所以要用到marked.js，因为项目已经有了components文件也有wxcomponents不想有太多的文件来放插件，所以没有通过npm install安装marked，按照插件文档一直报错，于是乎换插件 ：jo- markdown结果很神奇，插件的demo跑起来没问题，在项目里就渲染失败；于是乎在大神的帮助下又开始研究marked，再次更改插件以后引用了该插件的marked.js在u.parse里面。结果，神奇的事情发生了，渲染成功，仔细研究最后发现虽然两个文件都写的是marked的官网，但是他们里面的方法却做了改u.parse：调用marked.min.js，需要将marked(`ddd),修改为marked.parse(``);如果高光markdown调用要用marked(`xx`) ...继续阅读 (9)

Obsidian是个完全本地化的工具，除了用来做笔记，拿来做摘要和知识库其实也不错，只要不用担心在线服务的稳定性等问题。另一方面，关注了好几年，抓网页的好工具也就是剪藏（印象笔记）和简悦了，Bear、DevonTHINK虽然也有插件，但是前者的格式转换不太完美，后者的思路是保存WebArchive等，对markdown之类的转换也并不友好。所以几年前抛弃印象笔记后，主要就是依赖简悦，便宜、活儿好。对抓网帖来说，要纯本地化的塞进Obsidian，关键就是如何将图片等附件本地化。关联简悦来说，就是导出为TextBundle格式，自带了所有附件。向作者反馈过问题以后，有其他网友给了个挺好的解决思路，结合Hazel的文件夹监控和自动化动作实现整理。为了更契合我自己直接把帖子扔到一个文件夹的习惯，做了一些修改。首先，根据需要自己定义简悦的下载文件夹，这一步在简悦·同步助手里设置就行了，我直接定义到Obsidian文档库里。第二步，为下载文件夹设置一个Hazel规则，考虑到下载时间，这里设置为1分钟以后触发，并且在最后删除原.textbundle文件。第三步，关键是中间执行的脚本：string=$1 # 分割成 xxx.textbundle temp=${string##*\/} # 提取文章名 xxx article_name=${temp%%.*} folder_name=`echo ...继续阅读 (35)

Hugo 默认是不支持显示 LaTeX 风格的数学表达式的，Markdown 中的数学表达式语法在 Hugo 中默认并不会被识别。 在 Hugo 中引入 MathJax 即可解决该问题，MathJax ...继续阅读 (10)

博文经常更新，请移步主站查看🫡序 Keep It Simple, Stuipid!此书写于2003年，里边有一些东西是过时的。比如版本控制系统一节，并没有提到git（2005年才发明），同样，文档格式也没有markdown的内容。而有些内容，比如说到vi和emacs，或说到Windows时，有些过于有偏向性了，就像译者序里说的像个“美国愤青”... ...继续阅读 (13)

...继续阅读 (66)

第一章：R Markdown 简介 R Markdown 是 R 语言环境中提供的 markdown 编辑工具，运用 R Markdown 撰写文章，既可以像一般的 markdown 编辑器一样编辑文本，也可以在 R Markdown 中插入代码块，并将代码 ...继续阅读 (19)

这个“伪需求”是最近才想到的。关于文章管理的想法，说来话长。我最初是在 CSDN 写技术文章，就用网页上的编辑器。后来在 CppBlog 写，用上了 Windows Live Write，一般在 Word 里面写好，再贴到 WLW 发布。再后来由于太忙了，一直停到现在。其中除了我懒，有两个客观原因，第一是中间好几年不搞 C++，那么在 CppBlog 上写非 C++ 的东西好像有点奇怪；第二是，服务端的东西真的没法每天下班自己玩呀，每天下班提心吊胆地看短信报警，也没哪个心情和时间再去重新开辟一个和白天工作内容迥异的学习场景维持下去。（佩服自己找借口的能力~）前些年，Markdown 兴起，GitHub Pages 兴起，一众静态博客工具也蓬勃发展。Markdown 真的太适合用来写技术博客了，唯一不足是图片的处理。尽管如此，我还是花了很大的精力把以前所有的文章都转成了 Markdown。然后曾经一度也玩上了 GitHub Pages，用 Huge 生成静态博客。然而，博客的这东西我认为价值点和动力还是在于交流、碰撞，自己写自己看，跟存本地没啥区别——我的 GitHub Pages 几乎没人看……那时候也没写几篇，大概是 2018 年末到 2019 年初的时间。半年前，我想到了近年来第一个“伪需求”。我嫌 Hugo 这种形态操作太罗嗦：先写 Markdown，再放到 source r ...继续阅读 (7)