Converter tarefas do Obsidian entre formatos

Antes de mudar qualquer coisa

1. Faça backup do cofre. Copie a pasta ou faça commit no git. Um script que reescreve 4.000 linhas precisa ser fácil de desfazer.
2. Trabalhe primeiro numa cópia. Rode a conversão numa cópia do cofre, abra no Obsidian e execute uma das suas consultas de tarefas de sempre. Compare as contagens com o original.
3. Converta e depois troque o plugin. O Obsidian Tasks lê um formato por vez. Converta as linhas primeiro e depois mude o formato de tarefa nos ajustes dele, para que o plugin nunca veja um cofre meio convertido.
4. Confira o que sobrou. Busque no cofre os símbolos antigos (📅, ⏳, ⏫ para emoji; due::, repeat:: para Dataview) para achar as linhas que a receita pulou.

Qual conversão você precisa

De emoji para campos do Dataview

Cada emoji e seu valor viram um campo entre colchetes. Os emoji de prioridade viram um campo priority com uma palavra, e o texto de recorrência vai para dentro dos colchetes. Faça as substituições nesta ordem: datas e prioridade primeiro, recorrência por último, para que o texto da recorrência termine onde o próximo colchete começa.

Antes e depois

- [ ] Send invoice to Acme ⏫ 🔁 every month ➕ 2026-10-01 ⏳ 2026-11-01 📅 2026-11-03 #finance
- [x] Book flights 📅 2026-10-25 ✅ 2026-10-20
- [ ] Order parts 🆔 parts1
- [ ] Assemble 🛫 2026-11-10 ⛔ parts1 📅 2026-11-15

- [ ] Send invoice to Acme  [priority:: high]  [repeat:: every month]  [created:: 2026-10-01]  [scheduled:: 2026-11-01]  [due:: 2026-11-03] #finance
- [x] Book flights  [due:: 2026-10-25]  [completion:: 2026-10-20]
- [ ] Order parts  [id:: parts1]
- [ ] Assemble  [start:: 2026-11-10]  [dependsOn:: parts1]  [due:: 2026-11-15]

Localizar e substituir, um campo por vez

Esses padrões funcionam em qualquer editor com busca regex em vários arquivos, como o VS Code, que escreve o texto capturado como $1. Ative o modo regex e diferencie maiúsculas de minúsculas. Ao contrário do script, eles rodam em todas as linhas, não só nas de checkbox.

A mesma coisa como script

Salve como emoji_to_dataview.py e rode python3 emoji_to_dataview.py Inbox.md Projects/*.md. Ele mexe só em linhas de checkbox, escreve dois espaços antes de cada campo como o Obsidian Tasks faz e também converte os símbolos alternativos de vencimento e agendada 📆, 🗓 e ⌛.

#!/usr/bin/env python3
"""Rewrite Obsidian Tasks emoji fields to Dataview [key:: value] fields.

Usage: emoji_to_dataview.py NOTE.md [NOTE.md ...]   (rewrites in place; back up first)
Only checkbox lines are touched. Run it on a copy of your vault first.
"""
import os
import re
import sys

DATE = r"(\d{4}-\d{2}-\d{2})"
ID = r"[A-Za-z0-9_-]+"
RULES = [
    (rf"(?:📅|📆|🗓️?)\s*{DATE}", r"[due:: \1]"),
    (rf"(?:⏳|⌛)\s*{DATE}", r"[scheduled:: \1]"),
    (rf"🛫\s*{DATE}", r"[start:: \1]"),
    (rf"➕\s*{DATE}", r"[created:: \1]"),
    (rf"✅\s*{DATE}", r"[completion:: \1]"),
    (rf"❌\s*{DATE}", r"[cancelled:: \1]"),
    (r"🔺️?", "[priority:: highest]"),
    (r"⏫️?", "[priority:: high]"),
    (r"🔼️?", "[priority:: medium]"),
    (r"🔽️?", "[priority:: low]"),
    (r"⏬️?", "[priority:: lowest]"),
    (r"🏁\s*(keep|delete)", r"[onCompletion:: \1]"),
    (rf"🆔\s*({ID})", r"[id:: \1]"),
    (rf"⛔\s*({ID}(?:\s*,\s*{ID})*)", r"[dependsOn:: \1]"),
    # Last, so the rule text ends at the next bracket or the end of the line.
    (r"🔁\s*([A-Za-z0-9, !]*[A-Za-z0-9])(?=\s*(?:\[|\^|$))", r"[repeat:: \1]"),
]
TASK = re.compile(r"^(\s*(?:[-*+]|\d+\.)\s+\[.\]\s)(.*)$")

for path in sys.argv[1:]:
    out = []
    for raw in open(path, encoding="utf-8", newline="").read().split("\n"):
        cr = "\r" if raw.endswith("\r") else ""
        line = raw[: len(raw) - len(cr)]
        m = TASK.match(line)
        if m:
            head, body = m.groups()
            for pattern, repl in RULES:
                body = re.sub(pattern, repl, body)
            body = re.sub(r"\s*(\[(?:due|scheduled|start|created|completion|cancelled|priority|onCompletion|id|dependsOn|repeat):: )", r"  \1", body)
            line = head + body
        out.append(line + cr)
    tmp = path + ".tmp"
    with open(tmp, "w", encoding="utf-8", newline="") as fh:
        fh.write("\n".join(out))
    os.replace(tmp, path)

De campos do Dataview para emoji

A conversão inversa lê [key:: value] e (key:: value) e escreve os emoji padrão. Campos que ela não conhece, como [project:: Website], ficam na linha sem alteração, e uma prioridade escrita como número é deixada como está porque os plugins divergem sobre o que os números significam.

- [ ] Send invoice to Acme  [priority:: high]  [repeat:: every month]  [created:: 2026-10-01]  [scheduled:: 2026-11-01]  [due:: 2026-11-03] #finance
- [x] Book flights  [due:: 2026-10-25]  [completion:: 2026-10-20]
- [ ] Order parts  [id:: parts1]
- [ ] Assemble  [start:: 2026-11-10]  [dependsOn:: parts1]  [due:: 2026-11-15]

- [ ] Send invoice to Acme ⏫ 🔁 every month ➕ 2026-10-01 ⏳ 2026-11-01 📅 2026-11-03 #finance
- [x] Book flights 📅 2026-10-25 ✅ 2026-10-20
- [ ] Order parts 🆔 parts1
- [ ] Assemble 🛫 2026-11-10 ⛔ parts1 📅 2026-11-15

Executado sobre a saída do script anterior, devolve exatamente as linhas de exemplo acima. Cofres reais são menos arrumados: linhas que usavam 📆, 🗓 ou ⌛ voltam como 📅 ou ⏳, e uma linha com a descrição vazia ganha um espaço.

Salve como dataview_to_emoji.py e rode do mesmo jeito.

#!/usr/bin/env python3
"""Rewrite Dataview [key:: value] task fields to Obsidian Tasks emoji fields.

Usage: dataview_to_emoji.py NOTE.md [NOTE.md ...]   (rewrites in place; back up first)
Reads [key:: v] and (key:: v). Only checkbox lines are touched.
"""
import os
import re
import sys

DATE = r"(\d{4}-\d{2}-\d{2})"
ID = r"[A-Za-z0-9_-]+"


def field(key, value):
    return rf"[\[(]\s*{key}::\s*{value}\s*[\])]"


RULES = [
    (field("due", DATE), r"📅 \1"),
    (field("scheduled", DATE), r"⏳ \1"),
    (field("start", DATE), r"🛫 \1"),
    (field("created", DATE), r"➕ \1"),
    (field("completion", DATE), r"✅ \1"),
    (field("cancelled", DATE), r"❌ \1"),
    (field("priority", "highest"), "🔺"),
    (field("priority", "high"), "⏫"),
    (field("priority", "medium"), "🔼"),
    (field("priority", "low"), "🔽"),
    (field("priority", "lowest"), "⏬"),
    (field("onCompletion", "(keep|delete)"), r"🏁 \1"),
    (field("id", f"({ID})"), r"🆔 \1"),
    (field("dependsOn", rf"({ID}(?:\s*,\s*{ID})*)"), r"⛔ \1"),
    (field("repeat", r"([A-Za-z0-9, !]*[A-Za-z0-9])"), r"🔁 \1"),
]
TASK = re.compile(r"^(\s*(?:[-*+]|\d+\.)\s+\[.\]\s)(.*)$")

for path in sys.argv[1:]:
    out = []
    for raw in open(path, encoding="utf-8", newline="").read().split("\n"):
        cr = "\r" if raw.endswith("\r") else ""
        line = raw[: len(raw) - len(cr)]
        m = TASK.match(line)
        if m:
            head, body = m.groups()
            for pattern, repl in RULES:
                body = re.sub(pattern, repl, body, flags=re.I if "priority" in pattern else 0)
            line = head + re.sub(r"[ \t]{2,}", " ", body).rstrip()
        out.append(line + cr)
    tmp = path + ".tmp"
    with open(tmp, "w", encoding="utf-8", newline="") as fh:
        fh.write("\n".join(out))
    os.replace(tmp, path)

O que a conversão não cobre

• Uma linha com texto entre dois campos. O Obsidian Tasks lê a partir do fim da linha, então ele nem teria lido esses campos.
• Um link de bloco como ^abc123 no fim da linha. Os scripts o deixam onde está, que é onde o Obsidian o espera.
• Sintaxe exclusiva do Task Genius: horas depois das datas, prioridades [#A], campos de projeto e contexto, regras de recorrência do iCalendar. Deixe essas linhas em paz ou converta à mão.
• Regras de recorrência que um formato escreve de outro jeito. Confira algumas tarefas recorrentes depois da troca, principalmente as com when done.
• Tarefas recorrentes que já têm cópias concluídas no arquivo. As cópias são tarefas concluídas comuns e convertem como qualquer outra linha.
• Linhas dentro de blocos de código. Os scripts trabalham linha a linha e não conhecem as cercas, então converta à mão as notas que citam exemplos.
• Um campo não reconhecido no fim da linha, como [custom:: x]. O Obsidian Tasks lê a partir do fim, então para ali e ignora os campos convertidos que vêm antes.
• Uma regra 🔁 seguida de uma #tag. A recorrência fica sem converter, então mova a tag para antes dela ou converta essa linha à mão.
• Tarefas dentro de citações ou callouts (linhas que começam com > - [ ]). Os scripts as ignoram.
• Uma hora depois de uma data, como 14:30. Ela fica fora do campo convertido. O Obsidian Tasks não tem campo de hora, então só o Task Genius a lê.

De linhas de tarefa para arquivos de tarefa

Um arquivo de tarefa é uma nota com os campos da tarefa no frontmatter YAML, o formato que o TaskNotes usa. Nem todo campo de uma linha tem lugar nele. É assim que os campos se mapeiam para as propriedades do TaskNotes.

Para onde vai cada campo

due: 2026-11-03

scheduled: 2026-11-01

start: 2026-11-10

dateCreated: 2026-10-01T08:00:00Z

completedDate: 2026-10-20

priority: high

recurrence: "DTSTART:20261103;FREQ=MONTHLY"

tags:
  - finance

onCompletion: delete

id: parts1

blockedBy:
  - uid: "Tasks/Order parts.md"
    reltype: FINISHTOSTART

Uma linha por vez com o TaskNotes

O TaskNotes tem um comando Convert to TaskNote e um botão de converter ao lado dos checkboxes, que você pode ativar nos ajustes de recursos dele. Qualquer um dos dois cria um arquivo de tarefa novo a partir da linha e a substitui por um link para ele. Serve para poucas tarefas e é lento para um cofre inteiro.

Várias de uma vez com a linha de comando do TaskForge

O TaskForge é um app independente, e a ferramenta de linha de comando dele (que também é o motor do servidor MCP) converte tarefas entre linha e arquivo, nos dois sentidos, uma a uma ou em lote. Ela precisa de um cofre configurado para arquivos de tarefa, porque precisa saber como reconhecê-los. Faça a prévia primeiro. Um commit em lote precisa repetir o número de tarefas que a prévia encontrou, então uma consulta ampla demais não converte mais do que você pretendia.

taskforge convert --query 'tag:home' --to tasknotes --folder Tasks --dry-run
taskforge convert --query 'tag:home' --to tasknotes --folder Tasks --acknowledge-count 2

Uma execução real

- [ ] Send invoice to Acme ⏫ 🔁 every month 📅 2026-11-03 #finance

---
title: Send invoice to Acme
status: open
priority: high
tags:
  - finance
  - task
recurrence: "DTSTART:20261103;FREQ=MONTHLY"
due: 2026-11-03
---

A prioridade ⏫ virou high e every month virou uma regra do iCalendar ancorada na data de vencimento. Em uma segunda execução, uma data de início, uma ação ao concluir e um ID de tarefa foram mantidos como chaves comuns de frontmatter (start, onCompletion, id) em vez de descartados. O comando recusa qualquer tarefa que não consiga converter por inteiro. Converter um arquivo de volta para linha acrescenta à linha a tag que identifica o arquivo, task.

Para ir no sentido contrário, indique uma nota de destino e faça a prévia primeiro:

taskforge convert --query 'tag:home' --to inline --folder Inbox.md --dry-run

Perguntas frequentes