writing notes

hushvault notes are Markdown — ordinary text files with a few simple marks for formatting. There is no program to learn. This page is genuinely all of it.

← back to hushvault

You can just write

The first thing to know is that no marks are required. Open a note, write sentences, and you have a perfectly good note — searchable, taggable, linkable. Everything below is optional, added when it earns its place, and you see the result as you type: hushvault shows the formatted note live, and ⌘E (Ctrl+E on Windows) flips between reading and editing.

The marks

Seven cover everything most people ever do:

• # Petição inicial — a line starting with # becomes a title. ## makes a smaller one, for sections.
• **important** becomes important; *emphasis* becomes emphasis.
• Lines starting with - become a bulleted list; 1. starts a numbered one.
• - [ ] file the appeal becomes a checkbox you can click in the preview.
• A line starting with > becomes a quotation — good for cited passages.
• [[Contrato Silva]] links to another note or document by name. Links keep working when you rename or move things — hushvault updates them for you.
• A blank line starts a new paragraph. That's it.

Markdown is a public convention, not a hushvault invention — the same marks work in countless other apps, which is part of why your notes stay yours.

Why plain text is the point

A hushvault note is a file you could open in any text editor, today or in twenty years. Nothing about it is proprietary, so nothing about it can be taken away — no export step, no subscription holding your own writing. And plain text has a second life now: it is the one format every AI tool reads natively, which is what makes a well-kept vault such a good companion to one.

Beyond the marks

• Tags — add them from the bar above any note (with autocomplete). They are stored in the note itself, not in a hidden database.
• The daily note — one key creates today's note from a template, for the running log kind of writing.
• Paste anything — a screenshot pasted into a note becomes an image file in your vault, already embedded.
• Focus mode — fades everything but the paragraph you're writing.

If you remember one thing: write first, format later, or never. The library is for keeping what you know — the marks are just seasoning.