这篇文章是怎么来的
它不是用后台的可视化编辑器排出来的,而是用 Markdown 源码写成、然后一条命令发到站上的。
发布时用的是这个命令:
docker exec deploy-web-1 python manage.py publish_post article.md \
--title "用 Markdown 写博客:一篇示例,也是本站的格式说明" \
--tags "Markdown,写作,站点公告"
正文开头那段 --- 包围的内容叫 front-matter,用来声明标题、摘要、标签、分类:
---
title: "文章标题"
excerpt: "文章摘要"
tags: [Markdown, 写作]
category: Django技术
status: p
---
正文从这里开始……
排版能力一览
Markdown 源文本在这里,页面上会显示为正常段落。粗体、斜体、行内代码 都能正确显示。
引用块长这样:左侧一条竖线,文字略微倾斜,用来放引述或提示。
表格
| 能力 | 写法 | 支持情况 |
|---|---|---|
| 标题 | # 标题 |
✅ |
| 粗体 / 斜体 | **粗** / *斜* |
✅ |
| 行内代码 | `code` |
✅ |
| 围栏代码块 | ```lang |
✅ 带语法高亮 |
| 表格 | \| 列 \| 列 \| |
✅ |
| 引用块 | > 引用 |
✅ |
| 列表 | - 项 / 1. 项 |
✅ 支持嵌套 |
| 分隔线 | --- |
✅ |
| 链接 | [文字](地址) |
✅ |
| 图片 |  |
✅ 自动限宽 |
代码高亮
Python 代码:
def render_body(body, content_format):
"""把数据库里的原文转成页面要显示的 HTML。"""
if content_format == FORMAT_MARKDOWN:
return mark_safe(_markdown_to_html(body))
return mark_safe(body)
Shell 命令:
curl -s --noproxy '*' -m 15 -o /dev/null -w "HTTP %{http_code}\n" http://siliu.online/
列表
无序列表:
- 第一项
- 第二项
- 嵌套一项
- 嵌套二项
- 第三项
有序列表:
- 第一步
- 第二步
- 第三步
写在最后
从这篇开始,博客可以有两种写法:后台的可视化编辑器适合随手记,Markdown 源码适合写带表格和代码的技术文章。
两种格式可以混用——每篇文章各自记录自己用的是哪一种,页面按各自的方式渲染,互不干扰。
Last Modified·2026年10月27日 21:01
您尚未登录,请先登录才能评论。