47 Commits

Author SHA1 Message Date
Brian
bff39be923 Fix typo in sync-notes.md (#1553) 2025-11-24 14:34:20 +01:00
Riccardo
7afa286ea5 Improved support for link references (#1531)
* Support for links with references

* wikilink also use references

* Removed [[//begin]] and [[//end]] definitions from code and documentation
2025-10-29 16:38:18 +01:00
Riccardo Ferretti
4a7c2d9de2 Fixed links in documentation 2025-10-16 16:53:08 +02:00
CT Hall
61032668be Added FOAM_DATE_WEEK_YEAR template variable (#1532)
* Updated resolver to include FOAM_DATE_WEEK_YEAR
* Updated docs
2025-10-16 12:09:43 +02:00
Riccardo
9192cefc7c Improved tag search (fix #1516) (#1530) 2025-10-03 16:40:21 +02:00
Riccardo
40740db416 Add Link Conversion Commands and Auto-Convert on Completion (#1525)
* Added setting to automatically convert wikilinks into md links on insertion/completion
* Improved Position mock and added mock for `extensions` namespace

Fixes #1464
2025-10-02 10:48:47 +02:00
Riccardo
6d4db373bf #1328 Add support for wikilink image styling/sizing properties and title support in md image link (#1514)
* Support for image embed parameters (e.g. ![[img.png|300|center]])

Resolves #1328

Examples:

![[image.png]]              // Original
![[image.png|300]]          // Width only → 300px
![[image.png|50%]]          // Percentage → responsive
![[image.png|300x200]]      // Width × height
![[image.png|20em]]         // With units
![[image.png|300|center]]   // With alignment
![[image.png|300|Alt text]] // With alt text

* Documentation for image styling

* Add support for title in image links (#1262)

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-09-24 11:50:59 +02:00
Riccardo
a6c0cc603f Add FOAM_DATE_DAY_ISO template variable for ISO weekday number (1-7, Monday=1)
- Adds FOAM_DATE_DAY_ISO to variable resolver
- Adds dedicated and integrated tests for FOAM_DATE_DAY_ISO
- Updates documentation to describe FOAM_DATE_DAY_ISO usage and behavior
2025-09-15 14:28:31 +00:00
Riccardo
9ca36c9d81 Updated mermaid recommended extension 2025-09-08 12:00:49 +02:00
Riccardo Ferretti
65367b53b4 Doc fixes 2025-09-07 16:48:54 +02:00
Riccardo
5cbc722929 Add FOAM_CURRENT_DIR template variable (#1507)
* Added FOAM_CURRENT_DIR template variable

* Added /research-issue Claude command

* Added integration test to create note using FOAM_CURRENT_DIR

* Updated documentation

* fixed comment

* Fail FOAM_CURRENT_DIR resolution if no editor nor workspace is open
2025-09-06 15:25:06 +02:00
Riccardo Ferretti
f57b8ec9b6 Updated documentation 2025-09-06 11:54:15 +02:00
Riccardo Ferretti
4e0f6a5eeb Fixed typos in docs 2025-07-23 16:01:01 +02:00
Riccardo
71ddc3c4bc New note template engine (#1489)
- Template objects
- Separation of template loading, processing and file creation
- Support both Markdown and JavaScript templates
- Somewhat secure VM sandbox for JavaScript template execution in trusted workspaces
- Main entry point for note creation is `create-note` command
- Maintain backward compatibility with existing API

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-07-23 15:02:54 +02:00
Riccardo Ferretti
afbb40fe9b Fixed typo 2025-07-08 08:38:30 +02:00
Davi Figueiredo
7b96936926 docs: remove duplicate sentence (#1485) 2025-07-01 22:41:35 +02:00
David Jones
d55b592264 Recipe for publishing using Material for MkDocs (#1474) 2025-06-16 13:38:31 +02:00
Tenormis
2a197cfee5 Support custom fonts (#1457)
Co-authored-by: tenormis <tenormis@mars.com>
2025-04-19 19:09:39 +02:00
Riccardo Ferretti
c840070a3a renamed references to branch master into main 2025-03-07 17:11:11 +01:00
Riccardo
7d7446ef7e added reference to alias in documentation 2025-01-26 14:54:56 +01:00
Piotr Mrzygłosz
a8296c2c88 403 potential error-related comment (#1393) 2024-09-12 22:04:46 +02:00
Declan Millar
4989796cb0 docs: fix spelling and grammar (#1382) 2024-08-15 09:41:28 +02:00
Thomas Hegghammer
d24814d065 Add pdf export recipe (#1383) 2024-08-15 09:40:41 +02:00
Andrew Thiesen
e4f6259104 Update recipes.md (#1341)
REM foamy-js. https://github.com/yenly/foamy-nextjs has been Archived and is no longer being maintained.
2024-03-10 15:18:37 +01:00
Riccardo
cdbb965661 Update commands.md 2023-12-15 22:31:54 +01:00
Daniel Carosone
4276e8043f extension descriptions now reflect .vscode dir (#1302)
* extension descriptions now reflect .vscode dir

including that image pasting is now supported natively

* Markdown AiO is still recommended

---------

Co-authored-by: Daniel Carosone <dan@geek.com.au>
2023-10-26 10:24:51 +02:00
jonathan berger
bfcfad32e8 Add more detail to Support for sections. (#1296)
* Add more detail to Support for `sections`.

* Removed extra quote

---------

Co-authored-by: Riccardo <code@riccardoferretti.com>
2023-10-25 12:53:00 +02:00
Daniel Wang
e327115673 Feat #879: Note Embedding Syntax (#1281)
* Removed deprecated preview.embedNoteInContainer

* Integrate explicit type modifiers to wikilink syntax

* Add to documentation
2023-09-06 00:08:56 +02:00
Tony Cheneau
fb9447630f Update note-templates.md (#1267)
Fix typo (backticks instead of simple quotes)
2023-08-04 16:07:17 +02:00
Riccardo Ferretti
a00d18cfbb Fixed connections panel documentation (fixes @1244) 2023-06-19 13:08:16 +02:00
Riccardo
571b6a3528 Add FOAM_TITLE_SAFE variable (#1232)
* Introduced FOAM_TITLE_SAFE, which is the FOAM_TITLE variable with all the invalid path characters replaced by '-'

* (out of scope) In notes explorer show item description only when name is different from note title
2023-05-22 17:14:21 +02:00
Zhizhen He
626a323193 Add GH Action workflow to check spell (#1221) 2023-05-14 18:16:08 +02:00
Riccardo Ferretti
5dee7cb2c0 Fixed link in documentation (#1225) 2023-05-07 21:40:14 +02:00
Jim Graham
1c294d84c5 Enable tag completion in front matter (#1191)
* Addresses #1184

Currently tag completion only works in the front matter if you type a `#`
character. Adding the suggested tag will then mark the tag as a comment

```markdown
---
tags: #foo #bar
---
```

Update the tag completion provider to recognize if we are in the
front-matter, by using adding two functions to utils.ts. Because the
tag completion intellisense must be summoned with either the `#`
character or the keybinding (typically `ctrl+space`), allow
for 2 outcomes

1. if the tag is prefixed in the front matter with a `#`, remove it when
   substituting the tag.
2. If `ctrl-space` is used, recognize we are on the `tags: ` line and
   allow for non-`#` prefaced words.

The tag provider only works on the `tags: ` within the `tags: ` key of
the frontmatter. For example

```markdown
---
title: A title
tags:
 - foo
 - bar
 - |
```
(where `|` is the cursor) will provide suggestions for tags.

Outside the `tags:` element, suggestions will not be provided.
```markdown
---
title: A title
tags:
 - foo
 - bar
dates:
 - 2023-01-1
 - |
```

* Refactor into functions for front matter & content

Refactor the main provider method into two
sub-functions, one for front matter, one for
regular content. Add helper functions to generate
the `CompletionItems` and to find the start & end
indices of the last match to `#{tag}`.
2023-05-02 06:11:06 +02:00
Riccardo Ferretti
52b7f86a9f Updated TOC in FAQ docs 2023-03-22 10:56:11 -06:00
Joe Taber
2db7060124 Add GH Action workflow to sync user docs to template repo on change (#1180)
Also strips wikilinks during docs sync
fixes #1177
2023-03-22 17:47:22 +01:00
Riccardo
882b0b6012 Use filter in open-resource command (#1161)
* Added title param in create-note command

* Added utility functions for commands

* Use create-note command when dealing with placeholders

* Updated open-resource command to new pattern

* Pass workspace.isTrusted to createFilter

* Fixed bug when finding absolute paths in workspace without providing basedir

* open-resource command can also receive `uri` param to skip filtering step

* added tests

* added docs
2023-02-15 22:53:32 +01:00
Riccardo
2a14dc0c57 Added resource filters (#1158)
* Added note filter and a few tests

* Added expression for filters and trusted workspace support

* Consolidate `include` and `exclude` into `path` parameter

* Added documentation
2023-02-10 12:17:42 +01:00
Liu YongLiang
0e6b9f8c83 Add markup-converter recipe (#1138) 2023-01-11 19:21:17 +01:00
Numan Zaheer Ahmed
64638868c0 Fix minor typo in frequently-asked-questions.md (#1121) 2022-12-11 16:32:30 +01:00
jonathan berger
1d264dcb22 Add mention of FOAM_DATE_WEEK to documentation. (#1113)
Because it was added in code, but hard to search.

Co-authored-by: JPB <jonathan@ltmp.co>
2022-11-28 17:54:08 +01:00
sn3akiwhizper
6b2dda4a71 Documentation updates and cleaning (#1108)
* fixing some unmatched links, daily-note path note, start graphviz/tags/properties clarification

fixed links that didn't actually link to their target, add discussion about creating daily-notes in path based off date, then clarifying notes about styling graph viz and tags while enhancing the note properties descriptions by describing how properties are described and which properties are custom, which are foam-specific, and which are foam-template-specific

* add filter view, default variables to graphviz, and viewing tags in graphviz

graphviz: discuss filter view, add all changeable variables to graph style example, tags: describe viewing tags in the graphviz

* add small note about learning yaml

* last push fixing up some todos

* making recommended changes from PR request
2022-11-22 22:09:04 +01:00
luca
6497f527ca Updated FAQ (#1092)
Added an additional answer regarding publishing foam notes with graph view.
2022-10-25 09:09:17 +02:00
Carlo Bonamico
92932cd004 Update recommended-extensions.md (#1079)
Referenced Excalidraw support
2022-10-10 15:28:09 +02:00
Riccardo Ferretti
6012cc1b64 Updated docs for creating new notes 2022-09-30 19:43:56 +02:00
Riccardo Ferretti
f3a242251b Updated spell checking documentation (#1068) 2022-09-13 12:18:35 +02:00
Joe Taber
72694ad201 Reorganize docs folder; isolate dev docs and user docs; integrate foam-template docs (#1031)
* Reorganize docs folder; isolate dev docs and user docs; integrate foam-template docs

* Rename how-to to getting-started

* Fixup all references

* Fix contribution-guide.md

* Fix asset references

* Fix user/index.md

* Spelling is good.

Thanks @DrakeWhu

* Add note about how to wite docs for foam
2022-07-26 17:09:07 +02:00