#什么是 Markdown
几个记号,就定下文档的形态。
Markdown 是一种在文字中写下记号,用来决定标题、列表这些「形态」的写法。行首写 # 就是标题,写 - 就是列表。就这么简单。
要记的东西少,就能专心在写上。内容只是纯文字,用哪个应用打开都读得了,也能原样贴进 GitHub 或多数发布平台。ChatGPT 和 Claude 返回的文档,大多也是这种写法。
##什么是 Markdown
写下的,和看到的。
左边是敲下的字,右边是 Monoshiri 里的样子。这两者在同一个地方 — 没有切换到预览的操作。
标题
# 的个数就是层级。越多,颜色越淡、字号越小。
敲下的字
# 週報 ## 今週やったこと ### 見積もり
Monoshiri 里的样子
列表
行首写 -。用两个半角空格缩进就成了嵌套,记号的颜色会逐层变化。
敲下的字
- 見積もりを送った
- 先方の確認待ち
- 金額は据え置き Monoshiri 里的样子
编号列表
从 1. 开始。编号按你写的样子出来。
敲下的字
1. 下書き 2. 見直し 3. 送付
Monoshiri 里的样子
待办
- [ ] 是空框,- [x] 是已完成。方框可以直接点着切换。
敲下的字
- [x] 請求書を出す - [ ] 打ち合わせの日程
Monoshiri 里的样子
强调
** 夹起来是加粗,* 是斜体,~~ 是删除线。记号不会消失,会带上颜色。
敲下的字
金額は **据え置き**、条件は *要相談*、納期は ~~来週~~。
Monoshiri 里的样子
引用
行首写 >。用来放别人的话,或以后想回头看的一段。
敲下的字
> 最初のリリースは小さく。
Monoshiri 里的样子
分隔线
只有 --- 的一行。用在话题转折处。
敲下的字
ここまで --- ここから
Monoshiri 里的样子
文中代码
用 ` 夹起来。适合命令名和文件名。
敲下的字
`npm run build` を実行します。
Monoshiri 里的样子
代码块
用只有 ` 的行夹起来。后面写上语言就会上色,还能像 js:app.js 那样附上文件名。
敲下的字
```js:app.js const n = 1; console.log(n); ```
Monoshiri 里的样子
链接
[名称](URL)。写完只留下名称,点一下就打开。想改地址时,把光标放到旁边即可。
敲下的字
[請求書のひな形](https://example.com)
Monoshiri 里的样子
图片
。在本应用里,把图片拖进编辑器就行(会存到 ~/images/,这一行自动写好)。
敲下的字

Monoshiri 里的样子
附件
PDF 或表格文档拖进来会放进 ~/files/ 变成标签。PDF 就在本应用里打开。
敲下的字
[見積書.pdf](~/files/見積書.pdf)
Monoshiri 里的样子
表格
用竖线分列。可以从 / 建立,并直接改单元格的内容。
敲下的字
| 項目 | 状況 | | --- | --- | | 見積もり | 送付済み |
Monoshiri 里的样子
表格对齐
在第二行的 --- 上加 : 就能定对齐。:--- 左对齐,---: 右对齐,:---: 居中。
敲下的字
| 品名 | 数量 | | :--- | ---: | | りんご | 12 | | みかん | 300 |
Monoshiri 里的样子
单元格内换行
Markdown 的表格一行一条记录,所以用 <br>。输入时按 Shift+Enter 就会写上。
敲下的字
| 項目 | 覚え書き | | --- | --- | | 見積 | 送付済み<br>要確認 |
Monoshiri 里的样子
折叠
<details> 配 <summary>。可以把长内容收起来。在 GitHub 等地方也一样会折叠。
敲下的字
<details> <summary>長い話は畳んでおく</summary> 中身 </details>
Monoshiri 里的样子
图表
用 `mermaid 夹起来,就会按你写的画出图:流程图、时序图、饼图等。
敲下的字
```mermaid graph LR A[下書き] --> B[見直し] B --> C[送付] ```
Monoshiri 里的样子
公式
用 $ 夹起来是文中公式,用只有 $$ 的行夹起来就是整块公式。
敲下的字
$$ E = mc^2 $$
Monoshiri 里的样子
脚注
正文里放 [^1],另起一行写 [^1]: 内容。点哪一边都会跳到另一边。
敲下的字
本文に注を付ける[^1] [^1]: ここが注の中身。
Monoshiri 里的样子